smart_toy

MCP 接口指南

Model Context Protocol - AI 智能体项目信息获取接口

help_outline 什么是 MCP?

MCP (Model Context Protocol) 是一种开放协议,用于标准化 AI 智能体与外部数据源之间的通信。 通过 DevHub 的 MCP 接口,AI 可以获取平台上的开源项目信息,包括项目名称、描述、GitHub 地址、统计数据等。

link MCP 服务端点: https://devhub.fiime.cn/mcp.php

vpn_key 认证方式

调用 MCP 接口(除 server_info 外)需要提供有效的 Token 进行认证。 请先注册账号并在设置页面生成 MCP Token

方式一:HTTP Header(推荐)

X-MCP-Token: your-token-here

方式二:URL 参数

https://devhub.fiime.cn/mcp.php?action=get_projects_list&token=your-token-here

方式三: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)

GET/POST server_info

获取 MCP 服务器的基本信息和能力列表

curl -X GET "https://devhub.fiime.cn/mcp.php?action=server_info"
GET/POST get_projects_list

获取项目列表,支持分类筛选、排序和分页

curl -X GET "https://devhub.fiime.cn/mcp.php?action=get_projects_list&category=ai&sort=stars&page=1"
category: all/web/mobile/ai/tools/... sort: trending/stars/updated/newest page: 页码 per_page: 每页数量 (最大50)
GET/POST get_project_detail

获取单个项目的详细信息,包括语言占比、评论数等

curl -X GET "https://devhub.fiime.cn/mcp.php?action=get_project_detail&id=1"
curl -X GET "https://devhub.fiime.cn/mcp.php?action=get_project_detail&slug=devflow-ui"
id: 项目ID slug: 项目别名
GET/POST search_projects

根据关键词搜索项目

curl -X GET "https://devhub.fiime.cn/mcp.php?action=search_projects&query=react&page=1"
query: 搜索关键词 (必填) page: 页码 per_page: 每页数量
GET/POST get_project_stats

获取平台整体统计数据,包括项目总数、分类分布、热门语言等

curl -X GET "https://devhub.fiime.cn/mcp.php?action=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 参数认证)

curl -X GET "https://devhub.fiime.cn/mcp.php?action=search_projects&query=react&per_page=10&token=your-token-here"

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 接口,探索丰富的开源项目数据。