MCP网关开源项目教程

1. 项目介绍

MCP网关是一个先进的中间件解决方案，用于Model Context Protocol（MCP）服务器，它集中化和增强了您的AI基础设施。MCP网关作为LLM（大型语言模型）和其他MCP服务器之间的中介，提供以下功能：

• 从根目录下的mcp.json文件读取服务器配置。
• 管理已配置MCP服务器的生命周期。
• 拦截请求和响应，以过滤敏感信息。
• 为所有代理的MCP提供一个统一的接口。

2. 项目快速启动

安装

首先，安装mcp-gateway包：

pip install mcp-gateway

配置

确保你有一个mcp.json配置文件，它应该位于你的项目根目录。以下是一个配置文件的示例结构：

{
  "mcpServers": {
    "mcp-gateway": {
      "command": "mcp-gateway",
      "args": [
        "--mcp-json-path",
        "~/.cursor/mcp.json",
        "--enable-guardrails",
        "basic"
      ],
      "servers": {
        "filesystem": {
          "command": "npx",
          "args": [
            "-y",
            "@modelcontextprotocol/server-filesystem",
            "."
          ]
        }
      }
    }
  }
}

启动MCP网关

使用以下命令启动MCP网关服务器：

mcp-gateway --enable-guardrails basic

如果你想调试服务器，可以使用以下命令：

LOGLEVEL=DEBUG mcp-gateway --mcp-json-path ~/.cursor/mcp.json --enable-guardrails basic

3. 应用案例和最佳实践

敏感信息过滤

MCP网关会自动过滤响应中的敏感令牌，防止凭证泄露，同时提供所需的功能。

创建一个包含敏感信息的文件：

echo 'HF_TOKEN = "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"' > tokens.txt

当代理请求通过MCP网关读取这个文件时，敏感令牌会被过滤。

使用守卫插件

MCP网关支持多种守卫插件来增强安全和功能。例如，使用basic守卫插件来过滤基本密钥：

mcp-gateway --enable-guardrails basic

使用presidio守卫插件来进行更高级的敏感信息识别和脱敏：

pip install mcp-gateway[presidio]
mcp-gateway --enable-guardrails presidio

4. 典型生态项目

MCP网关的生态系统中，以下是一些典型的项目：

• server-filesystem: 一个基于Model Context Protocol的文件系统服务器。
• xetrack: 一个轻量级的包，用于追踪机器学习实验、基准测试和监视结构化数据。

这些项目可以与MCP网关结合使用，以构建更加强大和灵活的AI应用。