模型上下文协议服务器目录与运行监控API

MCPHub API是一个自动收集GitHub上的公开MCP服务器并进行每小时健康检查,通过REST API提供结果的服务器目录与运行监控服务。

  • by Tenormusica2024
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Tenormusica2024/mcphub-api

使用说明

MCPHub API

MCP(Model Context Protocol)服务器的目录和运行监视API。

从GitHub自动收集公开MCP服务器,并通过REST API提供每小时健康检查的结果。

本番 URL: https://mcphub-api-ycqe3vmjva-an.a.run.app

  • API文档:https://mcphub-api-ycqe3vmjva-an.a.run.app/docs
  • 健康检查:https://mcphub-api-ycqe3vmjva-an.a.run.app/health

端点

|端点|说明| |---|---| | GET /servers |MCP服务器列表(可在类别关键字健康状态下过滤)| | GET /servers/{id} 服务器详细信息 | GET /servers/{id}/health-history |健康检查履历|

查询参数

参数|说明|例| |---|---|---| | category 分类过滤器 database, browser, filesystem, code, productivity, api, search, other | | q |名前・说明の部分一致検索| q=postgres | | health |健康状态过滤器| up, down, unknown | | sort |排序项目| stars (默认), name, last_crawled_at | | page |页码| 1 | | per_page 1页的数量(最多100个) 20 |

本地开发

# 1. リポジトリをクローン
git clone https://github.com/Tenormusica2024/mcphub-api.git
cd mcphub-api

# 2. 仮想環境を作成
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 3. 依存パッケージをインストール
pip install -r requirements.txt

# 4. 環境変数を設定
cp env.example .env
# .env を編集して Supabase URL/キー・GitHub トークンを設定

# 5. Supabase スキーマを適用
# Supabase ダッシュボード → SQL Editor → supabase/schema.sql を実行

# 6. サーバー起動
uvicorn app.main:app --reload

# 7. クローラー実行(初回データ収集)
python scripts/crawl.py --max 100

费用计划

计划|月额|月请求| |---|---|---| |免费|0|100美元| |基本|9美元|5000| | Pro | $19 | 30,000+健康警报| 企业$49/无限+服务级别协议+专用支持

技术栈

  • API:FastAPI+Uvicorn
  • 数据库:Supabase(PostgreSQL)
  • 挂车: httpx 非同期 + GitHub GraphQL API
  • 部署:云运行+GitHub操作CI/CD