MCP-Proxy 项目使用教程

1. 项目目录结构及介绍

MCP-Proxy 是一个用于在不同服务器传输之间切换的工具。以下是项目的目录结构及其简单介绍：

mcp-proxy/
├── .github/              # GitHub 工作流和配置文件
├── .vscode/             # Visual Studio Code 项目配置
├── src/                  # 源代码目录
│   └── mcp_proxy/        # MCP-Proxy 的 Python 源代码
├── tests/               # 测试代码目录
├── .gitignore            # Git 忽略文件列表
├── Dockerfile            # Docker 容器构建文件
├── LICENSE              # 项目许可证文件
├── README.md            # 项目说明文件
├── codecov.yml          # CodeCov 配置文件
├── pyproject.toml        # Python 项目配置文件
└── smithery.yaml         # Smithery 配置文件

2. 项目的启动文件介绍

项目的启动主要通过 mcp-proxy 命令来执行。以下是启动文件的基本介绍：

• mcp-proxy 命令：这是项目的启动命令，用于启动 MCP-Proxy 服务。根据不同的模式，它可以通过不同的参数来启动。

  • stdio to SSE 模式：将 stdio 服务器连接到远程 SSE 服务器。
  • SSE to stdio 模式：将 SSE 服务器暴露为本地 stdio 服务器。

启动示例：

# stdio to SSE 模式
mcp-proxy http://example.io/sse

# SSE to stdio 模式
mcp-proxy --sse-port=8080 uvx mcp-server-fetch

3. 项目的配置文件介绍

MCP-Proxy 的配置主要通过命令行参数进行，但也可以通过环境变量来设置一些参数。以下是主要的配置文件和相关配置：

• 命令行参数：

  • command_or_url：指定 MCP 服务器 SSE 端点或要启动的 MCP stdio 服务器命令。
  • --sse-port：指定 SSE 服务器端口。
  • --sse-host：指定 SSE 服务器监听的主机 IP 地址。
  • --env：传递额外的环境变量给 stdio 服务器。
  • --pass-environment：传递所有环境变量给 stdio 服务器。
  • --no-pass-environment：不传递环境变量给 stdio 服务器。
  • --allow-origin：设置 CORS 配置。

• 环境变量：

  • API_ACCESS_TOKEN：可以用于替代 --headers 参数中的授权令牌。

配置示例：

# 设置环境变量
export API_ACCESS_TOKEN='your-access-token'

# 使用环境变量启动服务
mcp-proxy --sse-port=8080 uvx mcp-server-fetch