Mcpproxy

🚀 MCP SSE 代理服務器

MCP SSE 代理服務器基於 SSE 協議實現 MCP 協議代理功能。支持共享與獨立會話模式，具備靈活配置選項，還能集成 CURSOR 環境，為用戶提供便捷的代理服務。

🚀 快速開始

安裝

pip install mcp-sse-server

啟動服務器

python3 -m mcp.sse_server.run_sse_server --listen "127.0.0.1" --port 8000 --auth_key your_auth_key_here

✨ 主要特性

• 基本功能：提供 MCP 協議的代理服務器功能，支持 SSE（Server-Sent Events）傳輸協議。
• 架構模式：
  • 共享會話模式：多個客戶端可共享同一份上下文數據。
  • 獨立會話模式：每個客戶端擁有獨立的上下文數據。
• 動態配置：
  • 支持通過 URL 參數傳遞環境變量。
  • 提供簡單易用的配置方式。
• 連接能力：
  • 直接連接到工具執行環境。
  • 支持 CURSOR 協議集成。
• 安全特性：
  • 身份驗證：支持基於 URL 參數的認證機制，可擴展插件式認證模塊。
  • 數據保護：數據傳輸採用 SSL 加密，默認啟用，且有靈活的安全策略配置選項。

📦 安裝指南

本地安裝

pip install mcp-sse-server

高級安裝

# 示例：使用虛擬環境進行安裝
python3 -m venv mcp_env && \
source mcp_env/bin/activate && \
pip install mcp-sse-server

💻 使用示例

基礎用法

# 示例：本地運行MCP SSE服務器
python3 -m mcp.sse_server.run_sse_server --listen "::1" --port 8000 --auth_key your_auth_key_here

高級用法

工具執行

# 示例：配置並啟動帶有指定工具的MCP服務器
python3 -m mcp.sse_server.run_sse_server \
    --listen "0.0.0.0" \
    --port 8000 \
    --auth_key your_auth_key_here \
    --tools 'echo,cat,ls'

CURSOR集成

# 示例：配置 CURSOR 環境的MCP服務器
python3 -m mcp.sse_server.run_sse_server \
    --listen "127.0.0.1" \
    --port 8000 \
    --auth_key your_auth_key_here \
    --cursor_mode enable

連接服務器

# 示例：使用curl連接服務器
curl -X POST "http://127.0.0.1:8000/api" \
  --header "Content-Type: application/json" \
  --data-raw '{"command": "echo", "args": ["hello"]}'

📚 詳細文檔

配置選項

配置示例

{
    "server_name": "my_mcp_server",
    "listen_address": "0.0.0.0",
    "port_number": 8000,
    "auth_key": "your_auth_key_here",
    "tools_list": ["echo", "cat", "ls"],
    "cursor_mode": true
}

日誌記錄

啟用日誌記錄

# 示例：啟用調試級別的日誌記錄
python3 -m mcp.sse_server.run_sse_server \
    --listen "127.0.0.1" \
    --port 8000 \
    --auth_key your_auth_key_here \
    --log_level debug

日誌格式

# 示例：自定義日誌輸出格式
python3 -m mcp.sse_server.run_sse_server \
    --listen "127.0.0.1" \
    --port 8000 \
    --auth_key your_auth_key_here \
    --log_format "%(asctime)s - %(levelname)s - %(message)s"

錯誤處理

常見錯誤

• 認證失敗：未正確配置或傳遞有效的認證密鑰。
• 端口占用：目標端口已被其他程序佔用。
• 工具缺失：指定的工具不存在於系統中。

退出狀態碼

錯誤日誌格式

LEVEL TIMESTAMP - MSG

使用限制

• 最大連接數：默認支持 20 個併發連接，可配置擴展。
• 工具限制：僅支持預設的工具列表。

貢獻指南

• 代碼倉庫：GitHub 倉庫地址
• 問題反饋：請在 Issues 區提交問題和建議。

發展計劃

未來功能

• 擴展插件支持
• 多協議兼容性
• 高級安全特性

日誌示例

啟動日誌

INFO: Server started on port 8000 at address ::1
DEBUG: Loaded tools: ['echo', 'cat', 'ls']

請求日誌

INFO: Received request from 127.0.0.1:55556
DEBUG: Command received: echo, arguments: ["hello"]
INFO: Completed command execution in 0.002 seconds

錯誤日誌

ERROR: Authentication failed for request from 192.168.1.1:45678
CRITICAL: Server shutting down due to repeated authentication failures

部署指南

生產環境配置

• 反向代理：建議使用 Nginx 或 Apache。
• SSL 證書：必須啟用 HTTPS。
• 日誌管理：配置集中化日誌收集服務。

監控方案

• 狀態監控：定期檢查服務運行狀態。
• 性能指標：監控 CPU、內存使用情況。
• 錯誤警報：設置錯誤閾值觸發告警。

測試指南

單元測試

pytest tests/unit/ -v

集成測試

pytest tests/integration/ -v

性能測試

loadtest.py -c 100 -p 8000

開發指南

開發環境

• Python 版本：3.8+
• 依賴管理：使用 poetry 或 pipenv
• 代碼風格：遵循 PEP8 規範

貢獻流程

1. Fork 倉庫到個人賬號。
2. 創建功能分支。
3. 提交代碼並 Push 到遠程倉庫。
4. 提出 Pull Request。

📄 許可證

本項目採用 MIT License 許可協議。