AI导哈

多通道代理控制平台

MCP-Handle是一个集成了动态路由、多服务器管理和状态监控的多通道代理控制平台，适用于SaaS、数据和通信基础设施的集成与管理。

  • by WeatherPal-AI
  • Python
  • 本地部署
  • 254 星标
  • 更新于
在 GitHub 查看 WeatherPal-AI/MCP-handle

使用说明

MCP-Handle by 低温宝

为什么选择MCP手柄

  • 编排代理工具 使用Strata，我们的渐进式MCP路由器，可以控制功能调用。
  • 运行100多台第一方MCP服务器 （OAuth就绪）直接从存储库。
  • 对每次部署进行仪器和监控 通过嵌入新的MCP Handle Status服务（改编自JustSong的开源仪表板），获得丰富的健康和分析见解。
  • 快速运送客户 通过可运行的Discord、Slack、WhatsApp、CLI和web MCP客户端。

概览

  • Strata MCP路由器 –动态编排，使代理只在需要时看到他们需要的工具(open-strata/).
  • MCP服务器目录 –超过100个集成，涵盖SaaS、数据、通信和基础设施(mcp_servers/).
  • 多通道MCP客户端 –由官方MCP SDK支持的生产级机器人(mcp-clients/).
  • MCP手柄状态 –嵌入式状态中心，Go/RReact后端+前端(mcp_handle_status/).
  • 文档和指南 –为新品牌重新布线了全面的Mintlify文档(docs/).
workspace/
├── docs/                    # Mintlify documentation, API reference, and tutorials
├── mcp_servers/             # First-party MCP server implementations
├── mcp-clients/             # Discord, Slack, Web, WhatsApp MCP clients
├── open-strata/             # Progressive MCP orchestration engine
├── mcp_handle_status/       # New status & analytics dashboard (Go + React)
├── scripts/                 # Helper scripts (e.g., start_status_service.sh)
└── NOTICE, LICENSE          # Apache-2.0 root license + third-party attributions

快速入门

  1. 安装必备组件

    • Python 3.12+
    • Node.js 18+
    • 转到1.20+
    • Docker（可选但推荐）

  2. 克隆存储库

    git clone https://github.com/WeatherPal-AI/MCP-handle.git
cd MCP-handle

  3. 安装依赖项（可选的选择性步骤）

    # Install Strata CLI
cd open-strata
uv pip install -r requirements.txt  # or your preferred tool
cd ..

# Bootstrap client dependencies (example: Discord bot)
cd mcp-clients
uv sync
cd ..

  4. 在本地启动Strata

    cd open-strata
uv run strata --help

  5. 运行MCP手柄状态仪表板

    ./scripts/start_status_service.sh
# Frontend dev server : http://localhost:5173
# API & dashboard     : http://localhost:3000

    辅助脚本创建默认值 .env，构建React前端，并启动Go后端。日志被写入 mcp_handle_status/backend.log.

使用MCP服务器

  • 每台服务器都位于 mcp_servers/<integration> 使用特定语言的工具。
  • 支持OAuth的服务器消耗 _oauth_support/ 帮助和尊重新 MCP_HANDLE_* 环境变量。
  • Docker镜像和包元数据现在指向WeatherPal AI命名空间(ghcr.io/weatherpal-ai/..., @weatherpal-ai/...).
  • 示例食谱 examples/ 直接映射到新的Python(mcp_handle)以及TypeScript包。
# Example: run the GitHub MCP server in watch mode
cd mcp_servers/github
go run ./...

MCP手柄状态的可观察性

集成状态服务取代了原始项目中的专有仪表板。

  • 实时健康检查 用于stdio、SSE和可流式传输的HTTP服务器。
  • 安装管理器 使用npm/PyPI引导流。
  • 分析 （使用、延迟、故障模式）由SQLite开箱即用。

关键命令：

# Build the dashboard container
cd mcp_handle_status
docker build -t weatherpal-ai/mcp-handle-status .

# Run natively (already done by the helper script)
./run.sh

贡献

  • 分叉、分支和提交PR目标 main.
  • 保持代码注释简洁，并在行为发生变化时添加测试。
  • 如果您扩展了第三方代码（例如MCP句柄状态组件），请在中保留上游属性 NOTICE 以及组件的本地许可证。

许可证和治理

  • 根许可证： Apache-2.0（见 LICENSE).
  • 嵌入式代码： 来自JustSong开放项目的MIT许可部分仍在MIT内部 mcp_handle_status/.
  • 维护人员： WeatherPal-AI（低温宝）

未解决的问题和路线图项目在GitHub存储库中跟踪。加入讨论，提交功能请求，帮助MCP生态系统保持开放和对代理友好。

相关 MCP