关于 MCP Proxy Server
MCP Proxy Server 是一个 MCP 代理服务,可将多个 MCP 服务聚合到单一 HTTP 入口之后。它面向需要统一接入多个 MCP 服务的开发者和团队,支持 OAuth 授权后由代理持有并刷新令牌。
主要功能
- 01聚合多个 MCP 客户端的工具、提示词与资源
- 02支持 SSE 与 streamable HTTP 两种服务方式
- 03支持 stdio、sse、streamable-http 三种客户端类型
- 04代理统一持有并刷新下游 OAuth 令牌
- 05提供 Docker 镜像,可运行 npx 与 uvx 启动的服务
适用场景
- 01通过单一地址向客户端提供多个 MCP 服务
- 02为需要交互式 OAuth 的下游服务统一授权
- 03以容器方式部署共享的 MCP 代理
MCP 相关
MCP Proxy Server 同时作为 MCP 客户端连接下游的多个 MCP 服务,并作为 MCP 服务向上游客户端暴露聚合后的工具、提示词与资源。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://mcp.amap.com/sse?key=<YOUR_TOKEN>一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http proxy-tbxark https://mcp.amap.com/sse?key=<YOUR_TOKEN>Cursor.cursor/mcp.json
{"mcpServers":{"proxy-tbxark":{"type":"http","url":"https://mcp.amap.com/sse?key=<YOUR_TOKEN>"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"proxy-tbxark":{"type":"http","url":"https://mcp.amap.com/sse?key=<YOUR_TOKEN>"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"proxy-tbxark":{"type":"http","url":"https://mcp.amap.com/sse?key=<YOUR_TOKEN>"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"proxy-tbxark":{"serverUrl":"https://mcp.amap.com/sse?key=<YOUR_TOKEN>"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
26| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| branch | string | 是 | 要在其中创建或更新文件的分支 |
| content | string | 是 | 文件内容 |
| message | string | 是 | 提交消息 |
| owner | string | 是 | 仓库所有者(用户名或组织) |
| path | string | 是 | 创建或更新文件的路径 |
| repo | string | 是 | 仓库名称 |
| sha | string | 否 | 要替换文件的 SHA(更新现有文件时必須) |
详细介绍
MCP Proxy Server
一个 MCP 代理,可在单个 HTTP 入口后聚合多个 MCP 服务。
功能
- 代理多个 MCP 客户端:聚合来自多个服务的工具、提示词和资源。
- SSE 和可流式传输的 HTTP:通过 Server‑Sent Events 或可流式传输的 HTTP 提供服务。
- 灵活的配置:支持
stdio、sse和streamable-http客户端类型。 - OAuth 客户端支持:对需要交互式 OAuth 的下游服务(例如 Notion)授权一次,然后由代理为每个调用方持有并刷新令牌。
文档
- 配置:docs/configuration.md
- 用法:docs/usage.md
- 部署:docs/deployment.md
- Claude 配置转换器:https://tbxark.github.io/mcp-proxy
快速开始
从源代码构建
git clone https://github.com/tbxark/mcp-proxy.git
cd mcp-proxy
make build
./build/mcp-proxy --config path/to/config.json
通过 Go 安装
go install github.com/tbxark/mcp-proxy@latest
Docker
此镜像支持通过 npx 和 uvx 启动 MCP 服务。
docker run -d -p 9090:9090 -v /path/to/config.json:/config/config.json ghcr.io/tbxark/mcp-proxy:latest
# or provide a remote config
docker run -d -p 9090:9090 ghcr.io/tbxark/mcp-proxy:latest --config https://example.com/config.json
更多部署选项(包括 docker‑compose)请参阅 docs/deployment.md。
配置
完整的配置参考和示例请参阅 docs/configuration.md。 可通过以下网址使用在线 Claude 配置转换器:https://tbxark.github.io/mcp-proxy
用法
命令行标志、端点和身份验证示例请参阅 docs/usage.md。
致谢
- 本项目的灵感来自 adamwattis/mcp-proxy-server 项目
- 如果你对部署有任何疑问,可以参考 《在 Docker 沙箱中运行 MCP Server》(@ccbikai)
许可证
本项目采用 MIT License 授权。详情请参阅 LICENSE 文件。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。