Mcpproxy

🚀 MCP SSE 代理服务器

MCP SSE 代理服务器基于 SSE（Server-Sent Events）协议实现 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

📚 详细文档

配置示例

{
    "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
}

配置选项

连接方式

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

使用日志

启用日志记录

# 示例：启用调试级别的日志记录
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 区提交问题和建议。

项目信息

• 许可证：MIT License
• 贡献指南：欢迎通过 GitHub 提出 Pull Request。
• 问题反馈：请在 Issues 区提交问题。
• 版本信息：1.0.0

发展计划

未来功能

• 扩展插件支持
• 多协议兼容性
• 高级安全特性

日志示例

启动日志

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

开发指南

开发环境

• Python 版本：3.8+
• 依赖管理：使用 poetry 或 pipenv。
• 代码风格：遵循 PEP8 规范。

贡献流程

1. Fork 仓库到个人账号。
2. 创建功能分支。
3. 提交代码并 Push 到远程仓库。
4. 提出 Pull Request。

测试指南

单元测试

pytest tests/unit/ -v

集成测试

pytest tests/integration/ -v

性能测试

loadtest.py -c 100 -p 8000

部署指南

生产环境配置

• 反向代理：建议使用 Nginx 或 Apache。
• SSL 证书：必须启用 HTTPS。
• 日志管理：配置集中化日志收集服务。

监控方案

• 状态监控：定期检查服务运行状态。
• 性能指标：监控 CPU、内存使用情况。
• 错误警报：设置错误阈值触发告警。

⚠️ 重要提示

所有请求均需包含有效的认证密钥，建议在生产环境中启用 SSL 证书。

💡 使用建议

若遇到认证失败问题，请检查传递的认证密钥是否正确；若端口被占用，请确保目标端口未被其他程序占用；若工具不可用，请确认指定的工具已正确安装并可执行。