mcp-proxy

基本能力

产品定位

mcp-proxy 是一个协议转换工具，主要用于在不同服务器传输协议之间进行转换，以支持客户端的通信需求。

核心功能

1. stdio 到 SSE：将 stdio 通信转换为 SSE 通信，使不支持 SSE 的客户端能够与远程 SSE 服务器通信。
2. SSE 到 stdio：将 SSE 通信转换为 stdio 通信，使远程客户端能够访问本地 stdio 服务器。

适用场景

1. 客户端需要与远程 SSE 服务器通信，但原生不支持 SSE 协议。
2. 需要将本地 stdio 服务器暴露给远程客户端访问。

工具列表

1. mcp-proxy：主工具，支持两种模式的协议转换。
2. mcp-server-fetch：用于测试和示例的本地 stdio 服务器。

常见问题解答

1. 如何配置 stdio 到 SSE 模式？
2. 需要提供远程 SSE 服务器的 URL 作为第一个参数。
3. 如何配置 SSE 到 stdio 模式？
4. 需要提供本地 stdio 服务器的命令，并设置 --sse-port 参数。
5. 如何安装 mcp-proxy？
6. 可以通过 Smithery、PyPI、GitHub 或 Docker 安装。

使用教程

使用依赖

1. Python 3.x
2. pip 或 uv 工具（推荐）

安装教程

通过 Smithery 安装

npx -y @smithery/cli install mcp-proxy --client claude

通过 PyPI 安装

uv tool install mcp-proxy
# 或
pipx install mcp-proxy

通过 GitHub 安装

uv tool install git+https://github.com/sparfenyuk/mcp-proxy

通过 Docker 安装

docker run -t ghcr.io/sparfenyuk/mcp-proxy:v0.3.2-alpine --help

调试方式

测试 stdio 到 SSE 模式

mcp-proxy http://example.io/sse

测试 SSE 到 stdio 模式

mcp-proxy --sse-port=8080 uvx mcp-server-fetch &
mcp-proxy http://127.0.0.1:8080/sse

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。