MCP HTTP回声服务器
基于FastMCP 2.0构建的双模（有状态/无状态）MCP回声服务器，具有21个全面的调试工具。
特性
- 双模式操作：以有状态模式运行用于开发/调试，或以无状态模式运行以实现生产可扩展性
- 21调试工具：用于调试MCP、身份验证和状态管理的综合套件
- FastMCP 2.0：基于现代FastMCP框架，实现最佳性能
- 自动检测：根据您的环境自动检测最佳模式
- 会话管理：在有状态模式下通过消息队列提供完全会话支持
- 协议遵从：支持MCP协议2025-06-18、2025-03-26和2024-11-05
安装
# Install with pip
pip install mcp-http-echo-server
# Or install from source
git clone https://github.com/atrawog/mcp-http-echo-server.git
cd mcp-http-echo-server
pip install -e .快速开始
# Run with auto-detected mode
mcp-http-echo-server
# Run in stateless mode for production
mcp-http-echo-server --mode stateless --port 8080
# Run in stateful mode with debug logging
mcp-http-echo-server --mode stateful --debug
# List all available tools
mcp-http-echo-server --list-tools可用工具
回声工具（2）
echo-回显带有上下文信息的消息replayLastEcho-重放最后一条回显的消息（仅限状态模式）
调试工具（4）
printHeader-显示请求中的所有HTTP标头requestTiming-显示请求时间和性能指标corsAnalysis-分析CORS配置environmentDump-显示环境配置
身份验证工具（3）
bearerDecode-解码JWT承载令牌（无签名验证）authContext-显示完整的身份验证上下文whoIStheGOAT-AI驱动的编程卓越分析器
系统工具（2）
healthProbe-对服务进行深入的健康检查sessionInfo-显示会话信息和统计信息
状态工具（10）
stateInspector-深入检查国家仓库sessionHistory-显示会话事件历史记录stateManipulator-操纵调试状态sessionCompare-比较多个会话sessionTransfer-导出/导入/克隆会话stateBenchmark-基准状态操作sessionLifecycle-显示会话生命周期信息stateValidator-验证状态一致性requestTracer-跟踪请求流和上下文modeDetector-检测并解释操作模式
模式
状态模式
- 具有持久性的完整会话管理
- 异步客户端的消息队列
- 会话历史和回放功能
- 最适合：开发、调试、交互式会话
- 限制：单实例，内存使用率更高
无状态模式
- 无会话持久性
- 仅请求范围状态
- 横向可扩展
- 最适合：生产、无服务器、高流量API
- 限制：无重播，无会话历史记录
自动模式
根据环境自动检测最佳模式：
- Kubernetes→ 无状态
- AWS Lambda→ 无状态
- Docker/本地→ 有状态的
配置
环境变量
MCP_ECHO_HOST=0.0.0.0 # Host to bind to
MCP_ECHO_PORT=3000 # Port to bind to
MCP_ECHO_DEBUG=true # Enable debug logging
MCP_MODE=auto # Server mode (auto/stateful/stateless)
MCP_SESSION_TIMEOUT=3600 # Session timeout in seconds
MCP_PROTOCOL_VERSIONS=2025-06-18 # Supported protocol versions
MCP_STATELESS=false # Force stateless mode命令行选项
Options:
--host HOST Host to bind to (default: 0.0.0.0)
--port PORT Port to bind to (default: 3000)
--mode {auto,stateful,stateless} Server mode (default: auto)
--stateless Run in stateless mode
--stateful Run in stateful mode
--protocol-versions VERSIONS Comma-separated protocol versions
--session-timeout SECONDS Session timeout for stateful mode
--transport {http,stdio,sse} Transport type (default: http)
--debug Enable debug mode
--log-file PATH Log file path
--list-tools List all available tools
--version Show versionDocker使用
FROM python:3.11-slim
RUN pip install mcp-http-echo-server
EXPOSE 3000
CMD ["mcp-http-echo-server", "--host", "0.0.0.0", "--mode", "stateless"]# Build and run
docker build -t mcp-echo-server .
docker run -p 3000:3000 mcp-echo-server例子
卷曲测试
# Initialize session
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-06-18"},"id":1}'
# Call echo tool
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-H "Mcp-Session-Id: " \
-d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"echo","arguments":{"message":"Hello!"}},"id":2}'MCP客户端配置
{
"mcpServers": {
"echo-server": {
"url": "http://localhost:3000/mcp",
"transport": "http",
"stateless": false
}
}
}演出
无状态模式
- 每秒请求数：10000+
- 内存使用量：~50MB
- 启动时间：\<1s
- 水平缩放：是
状态模式
- 每秒请求数：5000+
- 内存使用量：~100MB+会话存储
- 启动时间：\<1s
- 会话容量：10000+并发
建筑
FastMCP Framework
├── Server Core
│ ├── Dual-mode support
│ ├── Session management
│ └── State adapter
├── Tools (21)
│ ├── Echo tools (2)
│ ├── Debug tools (4)
│ ├── Auth tools (3)
│ ├── System tools (2)
│ └── State tools (10)
└── Transports
├── HTTP (with SSE)
├── STDIO
└── SSE (legacy)贡献
欢迎投稿！请随时提交问题或拉取请求。
许可证
阿帕奇-2.0
作者
安德烈亚斯·特拉沃格(atrawog@gmail.com)