MCP 接口指南
Model Context Protocol - AI 智能体项目信息获取接口
help_outline 什么是 MCP?
MCP (Model Context Protocol) 是一种开放协议,用于标准化 AI 智能体与外部数据源之间的通信。 通过 DevHub 的 MCP 接口,AI 可以获取平台上的开源项目信息,包括项目名称、描述、GitHub 地址、统计数据等。
https://devhub.fiime.cn/mcp.php
vpn_key 认证方式
调用 MCP 接口(除 server_info 外)需要提供有效的 Token 进行认证。
请先注册账号并在设置页面生成 MCP Token。
方式一:HTTP Header(推荐)
方式二:URL 参数
方式三:POST Body
{
"action": "get_projects_list",
"token": "your-token-here",
"category": "ai"
}
warning 注意:每个 Token 每分钟最多允许 60 次请求。超出限制将返回 429 错误,请稍后重试。
dns 服务器信息
| 服务器名称 | DevHub MCP Server |
| 版本 | 1.1.0 |
| 协议版本 | 2024-11-05 |
| 认证 | Token 认证(必需) |
| 限流 | 60 次/分钟/Token |
| 支持格式 | JSON |
construction 可用工具 (Tools)
server_info
获取 MCP 服务器的基本信息和能力列表
get_projects_list
获取项目列表,支持分类筛选、排序和分页
get_project_detail
获取单个项目的详细信息,包括语言占比、评论数等
curl -X GET "https://devhub.fiime.cn/mcp.php?action=get_project_detail&slug=devflow-ui"
search_projects
根据关键词搜索项目
get_project_stats
获取平台整体统计数据,包括项目总数、分类分布、热门语言等
code 响应格式
所有接口返回统一的 JSON 格式:
{
"success": true,
"data": {
// 具体数据内容
}
}
错误响应格式:
{
"success": false,
"error": "错误描述信息"
}
terminal 使用示例
1. 获取 AI 分类的热门项目(Header 认证)
curl -X GET "https://devhub.fiime.cn/mcp.php?action=get_projects_list&category=ai&sort=stars&per_page=5" \ -H "X-MCP-Token: your-token-here"
2. 搜索 React 相关项目(URL 参数认证)
3. 获取项目详情
curl -X GET "https://devhub.fiime.cn/mcp.php?action=get_project_detail&slug=devflow-ui" \ -H "X-MCP-Token: your-token-here"
4. POST 请求示例(Body 认证)
curl -X POST "https://devhub.fiime.cn/mcp.php" \
-H "Content-Type: application/json" \
-d '{
"action": "search_projects",
"token": "your-token-here",
"query": "vue",
"page": 1,
"per_page": 5
}'
integration_instructions AI 智能体集成指南
AI 智能体可以通过 MCP 接口实时获取 DevHub 平台上的项目信息,用于:
- 回答用户关于开源项目的询问
- 推荐符合用户需求的项目
- 分析平台技术趋势和热门语言
- 获取项目详细信息和统计数据
lightbulb
提示:AI 智能体在调用接口时,应优先使用 slug 而非 id 来获取项目详情,因为 slug 是稳定且可读的标识符。
开始使用 DevHub MCP 接口,探索丰富的开源项目数据。