Juhe MCP Server

mcp-proxy是一个用于在服务器传输模式之间切换的工具，支持将标准输入输出（stdio）转换为服务器发送事件（SSE）或反向转换，便于不同客户端与服务器之间的通信。

开发者工具人工智能聊天机器人 #通信代理 #SSE转换 #标准IO #服务器桥接 .Python

评分 : 2分

下载量 : 12

更新时间 : 2025-04-28

什么是MCP代理？

MCP代理是一款桥梁工具，用于实现不同服务器传输协议之间的通信。它支持两种主要模式：将标准输入输出转换为SSE（Server-Sent Events）以及从SSE转回标准输入输出。通过这个工具，可以方便地在不同的协议之间进行数据传输。

如何使用MCP代理？

MCP代理的使用非常简单。首先需要安装该工具，然后根据需求选择合适的模式进行配置即可开始使用。具体的安装和配置步骤可以参考官方文档或GitHub仓库。

使用场景是什么？

MCP代理适用于多种场景，例如将本地的标准输入输出服务器暴露为SSE接口供远程客户端访问，或者将来自Web浏览器的SSE请求转发到后端服务。它特别适合在需要协议转换的应用中使用。

特性

优缺点

如何使用

使用示例

常见问题

标准输入输出和SSE模式之间有什么区别？

是否支持其他协议？

如何传递认证令牌？

额外资源

GitHub仓库

源代码和问题跟踪。

PyPI包

官方Python包。

模型上下文协议文档

🚀 MCP-Proxy 使用指南

MCP-Proxy 是一个支持两种模式（SSE 或 stdio 客户端）的代理工具，为用户提供便捷的代理服务。以下将详细介绍其安装、使用、测试等方面的内容。

🚀 快速开始

若你想快速使用 MCP-Proxy，可参考下面的安装步骤和使用示例。

📦 安装指南

使用 uv 工具安装

使用以下命令安装 mcp-proxy：

uv tool install mcp-proxy

通过 Docker 容器运行

从版本 0.3.2 开始，支持通过 Docker 容器运行。拉取镜像并启动容器：

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

扩展容器镜像

如果需要扩展镜像以包含其他可执行文件，可以创建自定义 Dockerfile：

# file: mcp-proxy.Dockerfile

FROM ghcr.io/sparfenyuk/mcp-proxy:latest

# 安装 'uv' 包
RUN python3 -m ensurepip && pip install --no-cache-dir uv

ENV PATH="/usr/local/bin:$PATH" \
    UV_PYTHON_PREFERENCE=only-system

ENTRYPOINT [ "mcp-proxy" ]

Docker Compose 配置

使用自定义 Dockerfile 定义服务：

services:
  mcp-proxy-custom:
    build:
      context: .
      dockerfile: mcp-proxy.Dockerfile
    network_mode: host
    restart: unless-stopped
    ports:
      - 8096:8096
    command: "--pass-environment --sse-port=8096 --sse-host 0.0.0.0 uvx mcp-server-fetch"

⚠️ 重要提示

不要忘记设置 --pass-environment 参数，否则会出现错误："在管理安装或搜索路径中未找到解释器"

💻 使用示例

基础用法

mcp-proxy http://localhost:8080/sse

高级用法

# 传递头信息
mcp-proxy --headers Authorization 'Bearer YOUR_TOKEN' http://localhost:8080/sse

# 设置环境变量
mcp-proxy -e DEBUG=true my_command.sh

📚 详细文档

命令行参数

usage: mcp-proxy [-h] [-H KEY VALUE] [-e KEY VALUE] [--pass-environment | --no-pass-environment] [--sse-port SSE_PORT] [--sse-host SSE_HOST]
                 [--allow-origin ALLOW_ORIGIN [ALLOW_ORIGIN ...]]
                 [command_or_url] [args ...]

启动 MCP 代理，支持两种模式：作为 SSE 或 stdio 客户端。

位置参数：
  command_or_url        连接的命令或 URL。当为 URL 时，将运行一个 SSE 客户端；否则将运行给定的命令并以 stdio 客户端连接。有关详细信息，请参阅相关选项。

选项：
  -h, --help            显示此帮助消息并退出

SSE 客户端选项：
  -H KEY VALUE, --headers KEY VALUE
                        向 SSE 服务器传递头。可以多次使用。
  
stdio 客户端选项：
  args                  给定命令的任何额外参数
  -e KEY VALUE, --env KEY VALUE
                        在 spawn 服务器时使用的环境变量。可以多次使用。
  --pass-environment, --no-pass-environment
                        在 spawn 服务器时传递所有环境变量。

SSE 服务器选项：
  --sse-port SSE_PORT   暴露的 SSE 服务器端口。默认是随机端口
  --sse-host SSE_HOST   暴露的 SSE 服务器主机。默认是 127.0.0.1
  --allow-origin ALLOW_ORIGIN [ALLOW_ORIGIN ...]
                        允许的 SSE 服务器来源。可以多次使用。默认不允许 CORS。