AI导哈

模块化MCP服务器

一个可扩展、支持插件且具备人机协作能力的MCP（模型上下文协议）服务器，适用于需要人工审核的敏感操作场景。

  • by getxmediaagency
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 getxmediaagency/mcp-server-webhook

使用说明

模块化MCP服务器

一个可扩展的、支持插件的MCP（模型上下文协议）服务器，具有人在环协作功能。

特性

  • 模块化架构：插件就绪操作注册表，便于扩展
  • 循环中的人类：敏感操作的内置审批工作流
  • 异步支持：aiohttp完全支持异步/等待
  • 综合录井：具有唯一请求跟踪的详细日志记录
  • 调试支持：每个操作都有唯一的ID用于可追溯性
  • 生产就绪：具有错误处理和监控功能的可扩展设计

建筑

mcp_server/
├── core/                 # Core server components
│   ├── server.py        # Main MCPServer class
│   ├── action_registry.py # Action management system
│   └── human_loop.py    # Human approval workflow
├── actions/             # Action implementations
│   ├── client_data.py   # Client data actions
│   └── ...             # Additional action modules
├── utils/               # Utility functions
├── config/              # Configuration management
└── __init__.py         # Package initialization

快速开始

  1. 再进行:

    pip install -r requirements.txt

  2. 启动服务器:

    python main.py

  3. 测试服务器:

    # Health check
curl http://localhost:8000/health

# Get client data
curl -X POST http://localhost:8000/api/action/get_client_data \
  -H "Content-Type: application/json" \
  -d '{"params": {"client_id": "test-client"}}'

API终点

核心终点

  • GET /health -健康检查
  • GET /api/status -服务器状态和调试信息
  • GET /api/actions -列出可用操作

动作执行

  • POST /api/action/{action_name} -执行操作
  • POST /api/approval/{request_id} -处理人工审批

人在循环工作流程

可以将操作配置为需要人工批准：

  1. 行动注册：设置 requires_approval=True 注册操作时
  2. 申请批复：服务器在调用操作时创建审批请求
  3. 人工审核：人工审核并批准/拒绝该操作
  4. 执行：已批准的操作将自动执行

发展

添加新操作

  1. 在中创建操作 mcp_server/actions/
  2. 使用 @action_handler 元数据装饰器
  3. 在中注册操作 main.py

示例操作

from mcp_server.core.action_registry import action_handler

@action_handler(
    description="My custom action",
    requires_approval=True
)
async def my_action(params: Dict[str, Any]) -> Dict[str, Any]:
    # Action implementation
    return {"result": "success"}

配置

服务器支持通过环境变量进行配置：

  • MCP_HOST：服务器主机（默认：localhost）
  • MCP_PORT：服务器端口（默认值：8000）
  • MCP_DEBUG：启用调试模式（默认值：false）

日志记录

服务器提供全面的日志记录：

  • 请求跟踪：每个请求都有一个唯一的ID
  • 性能监控：执行时间跟踪
  • 错误处理：带上下文的详细错误日志记录
  • 人体循环：审批工作流日志记录

生产部署

对于生产部署：

  1. 使用流程管理器（systemd、supervisor）
  2. 配置反向代理（nginx、Apache）
  3. 设置监控和警报
  4. 配置SSL/TLS证书
  5. 设置备份和恢复程序

贡献

  1. 遵循模块化架构
  2. 添加全面的文档
  3. 包括所有操作的唯一ID
  4. 使用异步操作进行彻底测试
  5. 对于敏感操作，遵循人在循环工作流程

相关 MCP