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
