MCP HubMCP Hub

API 文档

使用我们的 REST API 与 MCP Hub 集成。通过你的 API key 以编程方式访问数据。

身份验证

从你的账户获取 API key，并用它来验证你的请求。

查看身份验证

端点

使用我们的 REST API 端点以编程方式搜索和探索 MCP 数据。

查看端点

示例

通过代码示例和文档学习如何使用我们的 API。

查看示例

Cursor 集成

通过我们的 MCP 服务器集成，直接在 Cursor IDE 中使用 MCP Hub。

设置指南

概览

我们的 API 提供以编程方式搜索和探索 MCP 数据的能力。你可以用它将 MCP 信息集成到你的应用中。

身份验证

所有 API 端点都需要 API key。你可以在 API Keys 页面获取你的 API key。

API Key 用法

在 Authorization 头部中包含你的 API key：

Authorization: Bearer YOUR_API_KEY

速率限制

该 API 的速率限制为每小时 20 次请求。如果超过此限制，你将收到 401 Unauthorized 响应。

搜索 API

端点

GET /api/open/v1/search

根据关键词搜索 MCP。

参数

参数类型是否必填描述
keywordsstring是要查找的搜索词

请求示例

GET /api/open/v1/search?keywords=blockchain
Authorization: Bearer YOUR_API_KEY

响应示例

{
  "data": [
    {
      "name": "Blockchain Project",
      "brief": "A decentralized blockchain solution",
      "website_url": "https://example.com"
    }
  ],
  "count": 1
}

错误响应

状态码描述
400缺少必填参数
401无效的 API key 或超出速率限制
500服务器错误

MCP API

MCP Hub 提供用于搜索和获取 MCP 信息的 REST API 端点，以及一个兼容 Model Context Protocol (MCP) 的服务器端点。

MCP 协议服务器

POST/GET /api/open/mcp

该端点提供遵循 JSON-RPC 2.0 规范的标准 Model Context Protocol (MCP) 服务器实现，同时支持 HTTP POST 和 Server-Sent Events (SSE)，用于 MCP 搜索和详情获取功能。

MCP 方法

方法描述参数
initialize初始化 MCP 连接无
tools/list列出可用工具无
tools/call调用 search_mcp 或 get_mcp_detail 工具name (string)：工具名称
arguments (object)：工具参数

示例：初始化连接

POST /api/open/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize"
}

示例：搜索 MCP

POST /api/open/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "search_mcp",
    "arguments": {
      "keywords": "blockchain",
      "limit": 10
    }
  }
}

响应示例

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"success\": true, \"data\": [...], \"count\": 16}"
      }
    ]
  }
}

示例：获取 MCP 详情

POST /api/open/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "get_mcp_detail",
    "arguments": {
      "mcp_id": "your-mcp-uuid"
    }
  }
}

SSE 连接

GET /api/open/mcp
Authorization: Bearer YOUR_API_KEY
Accept: text/event-stream

Cursor IDE 集成

通过其 MCP 服务器配置，MCP Hub 可以轻松集成到 Cursor IDE。这让你可以直接在开发环境中搜索和探索 MCP。

配置设置

将以下配置添加到你的 Cursor MCP 设置文件中（通常位于 ~/.cursor/mcp.json）：

{
  "mcpServers": {
    "mcp-hub": {
      "url": "https://www.aimcp.info/api/open/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "YOUR_API_KEY_HERE",
        "Content-Type": "application/json"
      },
      "capabilities": {
        "tools": true
      }
    }
  }
}

在 Cursor 中使用

配置完成后，你可以直接在 Cursor 聊天会话中使用 MCP Hub 工具：

搜索 MCP

让 Cursor 搜索特定的 MCP：

“搜索与区块链相关的 MCP”

“查找用于数据库集成的 MCP”

“给我看用于 Web 开发的热门 MCP”

获取 MCP 详情

请求特定 MCP 的详细信息：

“获取 UUID 为 abc123… 的 MCP 详情”

“给我看更多关于 GitHub MCP 的信息”

可用工具

MCP Hub 集成在 Cursor 中提供以下工具：

工具描述参数
search_mcp按关键词搜索 MCPkeywords (string)：搜索词
limit (number，可选)：最大结果数（默认值：50）
get_mcp_detail获取特定 MCP 的详细信息mcp_id (string)：MCP 的 UUID

故障排查

连接问题

  • 确认你的 API key 正确且未过期
  • 检查该 URL 在你的网络中是否可访问
  • 确保 MCP 配置文件的语法是有效的 JSON

速率限制

  • API key 限制为每小时 20 次请求
  • 如果触及速率限制，请等待该小时重置