Echo Server

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 version

Docker使用

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)