MCP SSE 代理服务器

功能特性

• 基本功能：提供MCP协议的代理服务器功能，支持SSE（Server-Sent Events）传输协议
• 架构模式：
  • 共享会话模式：多个客户端可共享同一份上下文数据
  • 独立会话模式：每个客户端拥有独立的上下文数据
• 动态配置：
  • 支持通过URL参数传递环境变量
  • 提供简单易用的配置方式
• 连接能力：
  • 直接连接到工具执行环境
  • 支持CURSOR协议集成

使用场景

标准用例

# 示例：本地运行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
  

安全特性

• 身份验证：
  • 支持基于URL参数的认证机制
  • 可扩展插件式认证模块
• 数据保护：
  • 数据传输采用SSL加密，默认启用
  • 灵活的安全策略配置选项

安装指南

本地安装

pip install mcp-sse-server

高级安装

# 示例：使用虚拟环境进行安装
python3 -m venv mcp_env && \
source mcp_env/bin/activate && \
pip install mcp-sse-server

配置示例

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

错误处理

常见错误

• 认证失败：未正确配置或传递有效的认证密钥
• 端口占用：目标端口已被其他程序占用
• 工具缺失：指定的工具不存在于系统中

项目信息

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

发展计划

未来功能

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

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

配置选项

连接方式

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

安全注意事项

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

日志记录

# 示例：启用调试日志
python3 -m mcp.sse_server.run_sse_server --listen "127.0.0.1" --port 8000 --auth_key your_auth_key_here --log_level debug

错误处理

• 认证失败：401 Unauthorized
• 内部错误：500 Internal Server Error

使用限制

• 最大连接数：默认支持20个并发连接，可配置扩展
• 工具限制：仅支持预设的工具列表

贡献指南

• 代码仓库：GitHub 仓库地址
• 问题反馈：请在Issues区提交问题和建议

MCP SSE 代理服务器日志示例

启动日志

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

MCP SSE 代理服务器错误处理指南

常见问题

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

退出状态码

错误日志格式

LEVEL TIMESTAMP - MSG

MCP SSE 代理服务器配置文件示例

{
  "listen_address": "127.0.0.1",
  "port_number": 8000,
  "auth_key": "your-secret-key-here",
  "tools_list": ["echo", "cat", "ls"],
  "cursor_mode": false,
  "log_level": "info",
  "log_format": "%(asctime)s - %(levelname)s - %(message)s"
}

MCP SSE 代理服务器开发指南

开发环境

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

贡献流程

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

MCP SSE 代理服务器测试指南

单元测试

pytest tests/unit/ -v

集成测试

pytest tests/integration/ -v

性能测试

loadtest.py -c 100 -p 8000

MCP SSE 代理服务器部署指南

生产环境配置

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

监控方案

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