Juhe MCP Server

mcp-proxy是一個用於在服務器傳輸模式之間切換的工具，支持將標準輸入輸出（stdio）轉換為服務器發送事件（SSE）或反向轉換，便於不同客戶端與服務器之間的通信。

開發者工具人工智能聊天機器人 #通信代理 #SSE轉換 #標準IO #服務器橋接 .Python

評分 : 2分

下載量 : 10

更新時間 : 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。