返回市场
MCP管理器

MCP管理器

作者:WeatherPal-AI352 星标更新:2025-11-06

项目介绍

MCP-Handle by 低温宝

<div align="center"> <picture> <img src="./docs/images/logo/cover.png" width="100%"> </picture> </div> <div align="center">

文档 网站

<a href="https://www.producthunt.com/products/mcp-handle?utm_source=other&utm_medium=social" target="_blank" rel="noopener noreferrer"> <img src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1016948&theme=light&period=daily&t=1758639605639" alt="Strata - One MCP server for [...] </a> <a href="https://www.producthunt.com/products/mcp-handle?utm_source=other&utm_medium=social" target="_blank" rel="noopener noreferrer"> <img src="https://trendshift.io/api/badge/repositories/12132" alt="Trendshift.io Badge" style="width: 250px; height: 54px;" /> </a> </div>

为什么选择 MCP-Handle

  • 通过 Strata 进行代理工具编排,这是一个渐进式的 MCP 路由器,确保功能调用在控制之下。
  • 运行超过一百个原生 MCP 服务器(在需要的地方支持 OAuth),直接从仓库启动。
  • 监控每个部署,通过嵌入新的 MCP Handle 状态服务(基于 JustSong 的开源仪表板改编)获得丰富的健康和分析洞察。
  • 快速交付客户端,通过预配置的 Discord、Slack、WhatsApp、CLI 和 Web MCP 客户端。

快速概览

  • Strata MCP 路由器 – 动态编排,使代理仅在需要时看到所需的工具 (open-strata/)。
  • MCP 服务器目录 – 超过 100 个集成,涵盖 SaaS、数据、通信和基础设施 (mcp_servers/)。
  • 多渠道 MCP 客户端 – 由官方 MCP SDK 驱动的生产级机器人 (mcp-clients/)。
  • MCP Handle 状态 – 嵌入式状态中心,带有 Go/React 后端+前端 (mcp_handle_status/)。
  • 文档与指南 – 全面的 Mintlify 文档,重新设计以适应新品牌 (docs/)。
workspace/
├── docs/                    # Mintlify 文档,API 参考和教程
├── mcp_servers/             # 原生 MCP 服务器实现
├── mcp-clients/             # Discord、Slack、Web、WhatsApp MCP 客户端
├── open-strata/             # 渐进式 MCP 编排引擎
├── mcp_handle_status/       # 新的状态及分析仪表盘(Go + React)
├── scripts/                 # 辅助脚本(例如:start_status_service.sh)
└── NOTICE, LICENSE          # Apache-2.0 根许可 + 第三方归属声明

快速开始

  1. 安装先决条件

    • Python 3.12+
    • Node.js 18+
    • Go 1.20+
    • Docker(可选但推荐)
  2. 克隆仓库

    git clone https://github.com/WeatherPal-AI/MCP-handle.git
    cd MCP-handle
    
  3. 安装依赖项(可选步骤)

    # 安装 Strata CLI
    cd open-strata
    uv pip install -r requirements.txt  # 或您偏好的工具
    cd ..
    
    # 初始化客户端依赖项(示例:Discord 机器人)
    cd mcp-clients
    uv sync
    cd ..
    
  4. 本地启动 Strata

    cd open-strata
    uv run strata --help
    
  5. 运行 MCP Handle 状态仪表盘

    ./scripts/start_status_service.sh
    # 前端开发服务器:http://localhost:5173
    # API & 仪表盘: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 包。
# 示例:在监视模式下运行 GitHub MCP 服务器
cd mcp_servers/github
go run ./...

使用 MCP Handle 状态进行可观测性

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

  • 实时健康检查 对于标准 I/O、SSE 和可流式传输的 HTTP 服务器。
  • 安装管理器 带有 npm/PyPI 引导流程。
  • 分析(使用情况、延迟、故障模式)默认由 SQLite 提供支持。

关键命令:

# 构建仪表盘容器
cd mcp_handle_status
docker build -t weatherpal-ai/mcp-handle-status .

# 原生运行(已由辅助脚本完成)
./run.sh

贡献

  • 分叉、分支并提交针对 main 的 PR。
  • 保持代码注释简洁,并在行为更改时添加测试。
  • 如果扩展第三方代码(例如 MCP Handle 状态组件),请在 NOTICE 和组件本地的 LICENSE 中保留上游归属声明。

许可证与治理

  • 根许可证:Apache-2.0(见 LICENSE)。
  • 嵌入代码:源自 JustSong 开源项目的 MIT 许可部分,在 mcp_handle_status/ 内仍为 MIT 许可。
  • 维护者:WeatherPal-AI(低温宝)

在 GitHub 仓库中跟踪开放问题和路线图项目。加入讨论,提出功能请求,帮助 MCP 生态系统保持开放和代理友好。