Skip to content
Back to search

MCP-handle

MCP integration platforms making AI-Agents developers focusing on their own tasks

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/weatherpal-ai--mcp-handle/badge.svg)](/listings/weatherpal-ai--mcp-handle)

HTML

<a href="/listings/weatherpal-ai--mcp-handle"><img src="/api/listings/weatherpal-ai--mcp-handle/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. **Install prerequisites** - Python 3.12+ - Node.js 18+ - Go 1.20+ - Docker (optional but recommended)

2. **Clone the repository**

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

3. **Install dependencies (optional selective steps)**

   # 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. **Launch Strata locally**

   cd open-strata
   uv run strata --help

5. **Run the MCP Handle Status dashboard**

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

The helper script creates a default `.env`, builds the React frontend, and boots the Go backend. Logs are written to `mcp_handle_status/backend.log`.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 151 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MCP-Handle by 低温宝
  2. <div align="center">
  3. <picture>
  4. <img src="./docs/images/logo/cover.png" width="100%">
  5. </picture>
  6. </div>
  7. <div align="center">
  8. [![Documentation](https://img.shields.io/badge/Documentation-📖-green)](https://www.mcp-handle.com/docs) [![Website](https://img.shields.io/badge/Website-🌐-purple)](https://www.mcp-handle.com)
  9. <a href="https://www.producthunt.com/products/mcp-handle?utm_source=other&utm_medium=social" target="_blank" rel="noopener noreferrer">
  10. <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&#0032;MCP&#0032;server&#0032;for&#0032[...]
  11. " />
  12. </a>
  13. <a href="https://www.producthunt.com/products/mcp-handle?utm_source=other&utm_medium=social" target="_blank" rel="noopener noreferrer">
  14. <img src="https://trendshift.io/api/badge/repositories/12132" alt="Trendshift.io Badge" style="width: 250px; height: 54px;" />
  15. </a>
  16. </div>
  17. ---
  18. ## Why MCP-Handle
  19. - **Orchestrate agent tooling** with Strata, our progressive MCP router that keeps function calling under control.
  20. - **Run more than one hundred first-party MCP servers** (OAuth-ready where it matters) straight from the repository.
  21. - **Instrument and monitor every deployment** by embedding the new MCP Handle Status service (adapted from an open-source dashboard by JustSong) for rich health and analytics insights.
  22. - **Ship clients quickly** through ready-to-run Discord, Slack, WhatsApp, CLI, and web MCP clients.
  23. ---
  24. ## At a Glance
  25. - **Strata MCP router** – dynamic orchestration so agents only see the tools they need when they need them (`open-strata/`).
  26. - **MCP server catalog** – >100 integrations spanning SaaS, data, comms, and infra (`mcp_servers/`).
  27. - **Multi-channel MCP clients** – production-grade bots powered by the official MCP SDK (`mcp-clients/`).
  28. - **MCP Handle Status** – embedded status center with Go/React backend+frontend (`mcp_handle_status/`).
  29. - **Docs & guides** – comprehensive Mintlify docs rewired for the new brand (`docs/`).
  30. ```
  31. workspace/
  32. ├── docs/ # Mintlify documentation, API reference, and tutorials
  33. ├── mcp_servers/ # First-party MCP server implementations
  34. ├── mcp-clients/ # Discord, Slack, Web, WhatsApp MCP clients
  35. ├── open-strata/ # Progressive MCP orchestration engine
  36. ├── mcp_handle_status/ # New status & analytics dashboard (Go + React)
  37. ├── scripts/ # Helper scripts (e.g., start_status_service.sh)
  38. └── NOTICE, LICENSE # Apache-2.0 root license + third-party attributions
  39. ```
  40. ---
  41. ## Quickstart
  42. 1. **Install prerequisites**
  43. - Python 3.12+
  44. - Node.js 18+
  45. - Go 1.20+
  46. - Docker (optional but recommended)
  47. 2. **Clone the repository**
  48. ```bash
  49. git clone https://github.com/WeatherPal-AI/MCP-handle.git
  50. cd MCP-handle
  51. ```
  52. 3. **Install dependencies (optional selective steps)**
  53. ```bash
  54. # Install Strata CLI
  55. cd open-strata
  56. uv pip install -r requirements.txt # or your preferred tool
  57. cd ..
  58. # Bootstrap client dependencies (example: Discord bot)
  59. cd mcp-clients
  60. uv sync
  61. cd ..
  62. ```
  63. 4. **Launch Strata locally**
  64. ```bash
  65. cd open-strata
  66. uv run strata --help
  67. ```
  68. 5. **Run the MCP Handle Status dashboard**
  69. ```bash
  70. ./scripts/start_status_service.sh
  71. # Frontend dev server : http://localhost:5173
  72. # API & dashboard : http://localhost:3000
  73. ```
  74. The helper script creates a default `.env`, builds the React frontend, and boots the Go backend. Logs are written to `mcp_handle_status/backend.log`.
  75. ---
  76. ## Working with MCP Servers
  77. - Every server lives under `mcp_servers/<integration>` with language-specific tooling.
  78. - OAuth-capable servers consume the `_oauth_support/` helpers and respect the new `MCP_HANDLE_*` environment variables.
  79. - Docker images and package metadata now point to the WeatherPal-AI namespace (`ghcr.io/weatherpal-ai/...`, `@weatherpal-ai/...`).
  80. - Example recipes in `examples/` map directly to the new Python (`mcp_handle`) and TypeScript packages.
  81. ```bash
  82. # Example: run the GitHub MCP server in watch mode
  83. cd mcp_servers/github
  84. go run ./...
  85. ```
  86. ---
  87. ## Observability with MCP Handle Status
  88. The integrated status service replaces the proprietary dashboards from the original project.
  89. - **Live health checks** for stdio, SSE, and streamable HTTP servers.
  90. - **Installation manager** with npm/PyPI bootstrap flows.
  91. - **Analytics** (usage, latency, failure modes) backed by SQLite out-of-the-box.
  92. Key commands:
  93. ```bash
  94. # Build the dashboard container
  95. cd mcp_handle_status
  96. docker build -t weatherpal-ai/mcp-handle-status .
  97. # Run natively (already done by the helper script)
  98. ./run.sh
  99. ```
  100. ---
  101. ## Contributing
  102. - Fork, branch, and submit PRs targeting `main`.
  103. - Keep code comments concise and add tests where behaviour changes.
  104. - If you extend third-party code (e.g., the MCP Handle Status component), preserve upstream attribution in `NOTICE` and the component’s local LICENSE.
  105. ---
  106. ## License & Governance
  107. - **Root license:** Apache-2.0 (see `LICENSE`).
  108. - **Embedded code:** MIT-licensed portions sourced from an open project by JustSong remain under MIT inside `mcp_handle_status/`.
  109. - **Maintainer:** WeatherPal-AI(低温宝)
  110. Open issues and roadmap items are tracked in the GitHub repository. Join the discussion, file feature requests, and help the MCP ecosystem stay open and agent-friendly.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.