Secure Mcp Gateway

🚀 Enkrypt AI 安全 MCP 网关

Enkrypt AI 安全 MCP 网关是一款强大的工具，它位于 MCP 客户端和 MCP 服务器之间，提供认证、自动工具发现、缓存和护栏执行等功能，能有效保护 MCP 服务的安全与高效运行。

🚀 快速开始

若要开始使用 Enkrypt AI 安全 MCP 网关，你需要完成以下步骤：

1. 确保满足所有先决条件，包括安装必要的依赖项和工具。
2. 根据需求选择本地安装或等待即将推出的远程安装。
3. 配置网关，可参考示例配置文件进行必要的修改。
4. 重启 Claude Desktop 以启动网关，并验证其是否正常运行。

✨ 主要特性

Enkrypt AI 安全 MCP 网关具备以下主要特性：

1. 认证：使用唯一密钥进行网关认证，若需使用 Enkrypt 护栏保护 MCP，还可使用 Enkrypt API 密钥。
2. 易用性：可在配置文件中本地配置所有 MCP 服务器，或在 Enkrypt 中配置（即将推出），并通过名称在网关中使用。
3. 动态工具发现：网关能动态从 MCP 服务器发现工具，并提供给 MCP 客户端使用。
4. 限制工具调用：可在网关配置中明确指定允许的工具，限制 MCP 客户端对某些工具的访问。
5. 缓存：将用户网关配置和从 MCP 服务器发现的工具缓存到本地或外部缓存服务器（如 KeyDB），以提高性能。
6. 护栏：可在 Enkrypt 中为每个 MCP 服务器配置输入和输出护栏，提供全面的安全保护。
7. 日志记录：记录网关的所有请求和响应，本地存储在 MCP 日志中，并可转发到 Enkrypt 进行监控（即将推出）。

🔒 护栏

Enkrypt 护栏提供全面的输入和输出保护：

• 输入保护：包括主题检测、NSFW 过滤、毒性检测、注入攻击预防、关键词检测、政策违规检测、偏见检测和 PII 编辑（更多功能即将推出，如系统提示保护、版权保护等）。
• 输出保护：涵盖所有输入保护功能，以及一致性检查和相关性验证（更多功能即将推出，如幻觉检测等）。若输入时进行了编辑，响应将自动恢复。

📦 安装指南

本地安装

1. 克隆仓库、设置虚拟环境并安装依赖

git clone https://github.com/enkryptai/secure-mcp-gateway
cd secure-mcp-gateway

2. 运行设置脚本

该脚本将根据 example_enkrypt_mcp_config.json 文件在根目录下创建 enkrypt_mcp_config.json 文件，并进行必要的替换。同时，它会在 Claude Desktop 中安装 MCP 客户端。

# Linux/Mac
cd scripts
chmod +x *.sh
./setup.sh
# Windows
cd scripts
setup.bat

运行脚本后，请重启 Claude Desktop 以查看网关运行情况。

3. 生成示例 MCP 配置文件

4. 重启 Claude Desktop 以运行网关

重启后，导航到 Claude Desktop 的 设置，点击 开发者 -> Enkrypt Secure MCP Gateway 以验证网关是否正常运行。

5. 示例提示

• 列出所有服务器，获取所有可用工具并进行 echo 测试
  • 此提示使用测试 MCP 服务器 echo_server（位于 test_mcps/echo_mcp.py）。

6. 生成示例配置文件

示例 enkrypt_mcp_config.json 文件：

{
"common_mcp_gateway_config": {
"enkrypt_log_level": "INFO",
"enkrypt_guardrails_enabled": false,
"enkrypt_base_url": "https://api.enkryptai.com",
"enkrypt_api_key": "YOUR_ENKRYPT_API_KEY",
"enkrypt_use_remote_mcp_config": false,
"enkrypt_remote_mcp_gateway_name": "enkrypt-secure-mcp-gateway-1",
"enkrypt_remote_mcp_gateway_version": "v1",
"enkrypt_mcp_use_external_cache": false,
"enkrypt_cache_host": "localhost",
"enkrypt_cache_port": 6379,
"enkrypt_cache_db": 0,
"enkrypt_cache_password": null,
"enkrypt_tool_cache_expiration": 4,
"enkrypt_gateway_cache_expiration": 24,
"enkrypt_async_input_guardrails_enabled": false,
"enkrypt_async_output_guardrails_enabled": false
},
"gateways": {
"tLIYf0YEFTIPLXDO337zPRQhmnoXnLqLUKB3XuDX1inent9vGRFvwLDJGoeaktWu": {
"id": "2536722c-e5d7-4719-97ab-2cdd4ce942c0",
"mcp_config": [
{
"server_name": "echo_server",
"description": "Dummy Echo Server",
"config": {
"command": "python",
"args": [
"C:\\Users\\PC\\Documents\\GitHub\\enkryptai\\enkrypt-secure-mcp-gateway\\test_mcps\\echo_mcp.py"
]
},
"tools": {},
"input_guardrails_policy": {
"enabled": false,
"policy_name": "Sample Airline Guardrail",
"additional_config": {
"pii_redaction": false
},
"block": [
"policy_violation"
]
},
"output_guardrails_policy": {
"enabled": false,
"policy_name": "Sample Airline Guardrail",
"additional_config": {
"relevancy": false,
"hallucination": false,
"adherence": false
},
"block": [
"policy_violation"
]
}
}
]
}
}
}

7. 根据需要编辑网关配置

编辑配置文件后，需重启 Claude Desktop。使用提示 "列出所有服务器，获取所有可用工具" 让 MCP 客户端发现所有新工具。

远程安装

即将推出

💻 使用示例

基础用法

在 Claude Desktop 中使用以下提示测试网关：

列出所有服务器，获取所有可用工具并进行 echo 测试

高级用法

组合多个提示以触发多个工具调用：

echo 测试并 echo best

📚 详细文档

MCP 网关工作原理的高级步骤

先决条件

• 从 Claude 官网 安装 Claude Desktop 作为 MCP 客户端并登录。
  • 若使用 Linux 且无法运行 非官方版本 的 Claude Desktop，可使用 任何支持的 MCP 客户端 测试网关。
• MCP 服务器所需的其他依赖项，如 Node.js、npx、docker 等。
• （可选）安装并运行缓存服务器（如 KeyDB）以进行外部缓存。

（可选）将 GitHub MCP 服务器添加到网关

GitHub MCP 服务器 需要安装 docker，请确保 docker 已安装并运行。

（可选）免费使用 Enkrypt 护栏保护 GitHub MCP 服务器和测试 Echo 服务器

微调护栏

安全提示 列出 https://github.com/enkryptai/enkryptai-mcp-server 中的所有文件 在输出端启用注入攻击时可能会被阻止，因此需要微调护栏以找到适合服务器的最佳检测器和阻止规则组合。具体建议见下一节。

使用护栏的建议

• 为每个服务器创建单独的护栏，以实现精细调整。
• 不同 MCP 服务器可能需要不同的检测器，如毒性检测、NSFW 检测、注入攻击检测等，可根据需求组合使用。
• 部分服务器可能需要输入护栏，部分需要输出护栏，部分可能两者都需要。
• 参考 各种可用的检测器 进行配置。
• 尝试使用自定义策略的 策略违规 检测器，明确允许和禁止的内容。

设置其他 MCP 客户端

其他可用工具

部署模式

1. 本地网关、本地护栏和本地 MCP 服务器
2. 本地网关、带远程护栏的本地 MCP 服务器
3. 带远程 MCP 服务器和远程护栏的本地网关
4. 远程网关、远程 MCP 服务器和远程护栏

1. 本地网关、本地护栏和本地 MCP 服务器

2. 本地网关、带远程护栏的本地 MCP 服务器

3. 带远程 MCP 服务器和远程护栏的本地网关

4. 远程网关、远程 MCP 服务器和远程护栏

正在处理的已知问题

输出护栏目前不适用于非文本工具结果，即将支持图像、音频等其他媒体类型。

已知限制

网关不支持远程部署但 MCP 服务器本地部署（未暴露到互联网）的场景，因为网关需要知道 MCP 服务器的地址才能转发请求。

贡献

欢迎查看 TODO 列表，报告或修复遇到的任何错误。

🔧 技术细节

架构概述

Enkrypt AI 安全 MCP 网关采用分层架构，主要由网关服务器、网关客户端和护栏模块组成。网关服务器负责接收和处理 MCP 客户端的请求，网关客户端负责与 MCP 服务器通信，护栏模块则提供输入和输出保护。

代码实现

• src/gateway.py：处理 MCP 客户端的连接和请求。
• src/client.py：负责与 MCP 服务器通信，转发请求和接收响应。
• src/guardrail.py：实现输入和输出护栏的验证逻辑。

缓存机制

网关支持本地缓存和外部缓存（如 KeyDB），可通过配置文件进行设置。缓存包括网关配置和工具信息，可提高性能并减少对 MCP 服务器的请求。

护栏功能

护栏模块提供多种检测功能，包括主题检测、NSFW 过滤、毒性检测等。可根据需求配置不同的检测器和阻止规则，确保 MCP 服务的安全。

📄 许可证

Enkrypt AI MCP 网关核心

本项目的核心功能采用 MIT 许可证授权。完整的许可证文本请参阅仓库中的 LICENSE.txt 文件。

Enkrypt AI 护栏、标志和品牌

© 2025 Enkrypt AI。保留所有权利。 Enkrypt AI 软件采用专有许可证提供。未经授权，严禁使用、复制或分发本软件或其任何部分。 使用条款：https://www.enkryptai.com/terms-and-conditions 隐私政策：https://app.enkryptai.com/privacy-policy Enkrypt AI 和 Enkrypt AI 标志是 Enkrypt AI, Inc. 的商标。

返回顶部