Mcp Hub Tool

MCP Hub 工具 - HTTP MCP 服务文档

这是 MCP Hub 基于 HTTP 的 MCP（模型上下文协议）服务的文档和配置仓库。该服务通过标准化的 HTTP 接口支持搜索和发现 MCP。

概述

MCP Hub 在 Next.js 应用中实现了 Model Context Protocol (MCP) HTTP 端点，为 AI 助手和开发工具提供了一种现代且易于访问的方式，用于发现和使用来自 MCP Hub 的 MCP。

协议支持

⚠️ 重要变更：此服务仅支持基于 HTTP 的 MCP 连接。传统的基于 stdio 的实现已弃用，改为采用更易于访问且更可靠的 HTTP 接口。

简介

mcp-hub-tools 提供了与 MCP Hub 交互的文档和配置。该服务提供标准化的 JSON-RPC 2.0 端点，用于搜索 MCP 并获取已注册模型上下文协议的详细信息。

服务实现位置：HTTP MCP 服务实际实现在 MCP Hub 的 Next.js 应用中，路径为 /nextjs/app/api/open/mcp/route.ts。

可用工具

HTTP MCP 服务通过 JSON-RPC 2.0 提供以下工具：

search_mcp

• 说明： 使用关键词搜索 MCP Hub 数据库中的 MCP。返回匹配的 MCP 列表及其基本信息。
• 输入架构：

  {
    "type": "object",
    "properties": {
      "keywords": {
        "type": "string",
        "description": "用于搜索 MCP 名称、说明和元数据的关键词"
      },
      "limit": {
        "type": "number",
        "description": "返回结果的最大数量（默认值：50）",
        "default": 50
      }
    },
    "required": ["keywords"]
  }
  

• 输出： 返回包含 MCP 基本信息的搜索结果，包括：
  • uuid：MCP 的唯一标识符
  • name：MCP 名称
  • brief：简短说明
  • clicks：使用统计信息
  • count：找到的结果总数
  • keywords：使用的搜索词

get_mcp_detail

• 说明： 使用 MCP 的 UUID 获取特定 MCP 的详细信息。
• 输入架构：

  {
    "type": "object",
    "properties": {
      "mcp_id": {
        "type": "string",
        "description": "要获取详细信息的 MCP 的 UUID"
      }
    },
    "required": ["mcp_id"]
  }
  

• 输出： 返回完整的 MCP 信息，包括：
  • id：内部数据库 ID
  • uuid：唯一标识符
  • name：MCP 名称
  • brief：说明
  • website_url：官方网站
  • author_name：创建者信息
  • created_at / updated_at：时间戳
  • is_recommended / is_official：状态标志
  • clicks：使用统计信息
  • tags：关联的类别
  • metadata：其他信息
  • mcp_avatar_url / user_avatar_url：个人资料图片

工具响应示例

search_mcp 响应示例

{
  "success": true,
  "data": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Blockchain MCP",
      "brief": "A Model Context Protocol for blockchain data analysis",
      "clicks": 142
    }
  ],
  "count": 1,
  "total_results": 1,
  "keywords": "blockchain"
}

get_mcp_detail 响应示例

{
  "success": true,
  "data": {
    "id": 123,
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Blockchain MCP",
    "brief": "A comprehensive Model Context Protocol for blockchain data analysis",
    "website_url": "https://github.com/example/blockchain-mcp",
    "author_name": "Example Developer",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-03-20T14:45:00Z",
    "is_recommended": true,
    "is_official": false,
    "clicks": 142,
    "tags": ["blockchain", "crypto", "data-analysis"],
    "metadata": {
      "version": "1.2.0",
      "license": "MIT"
    },
    "mcp_avatar_url": "https://example.com/avatar.png",
    "user_avatar_url": "https://example.com/user.png"
  }
}

基于 HTTP 的 MCP 服务

MCP Hub 在其 Next.js 应用中提供了现代化的基于 HTTP 的 MCP 服务实现，与传统的基于 stdio 的方式相比，具有更高的可靠性和易用性。该服务使用 JSON-RPC 2.0 over HTTP 实现 Model Context Protocol。

服务端点

生产环境 URL：https://www.aimcp.info/api/open/mcp

支持的传输方式

• HTTP POST：标准 JSON-RPC 2.0 请求
• Server-Sent Events (SSE)：实时流式连接，便于客户端集成

主要功能

• ✅ 符合 JSON-RPC 2.0：完全兼容 MCP 协议规范
• ✅ 支持双传输方式：通过 HTTP POST 和 SSE 满足不同客户端的需求
• ✅ API 密钥身份验证：安全访问控制
• ✅ 速率限制：内置防滥用保护
• ✅ 支持 CORS：允许跨域请求
• ✅ 错误处理：完善的错误响应

使用方法

先决条件

• 从 MCP Hub 获取 API 密钥（https://www.aimcp.info）

如何获取 API 密钥

1. 访问 https://www.aimcp.info
2. 注册或登录你的账户
3. 前往 API Keys 页面
4. 为你的应用生成新的 API 密钥

注意：API 密钥的速率限制为每小时 20 次请求。

身份验证

所有发往 HTTP MCP 服务的请求都必须在 Authorization 标头中使用 Bearer 令牌进行身份验证：

Authorization: Bearer YOUR_API_KEY

MCP 客户端配置

基于 HTTP 的配置（推荐）

现代 MCP 客户端可以直接连接到 HTTP 服务：

{
  "mcpServers": {
    "mcp-hub": {
      "url": "https://www.aimcp.info/api/open/mcp",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

简化配置

对于支持简化配置的客户端：

{
  "mcpServers": {
    "mcp-hub": {
      "url": "https://www.aimcp.info/api/open/mcp",
      "apiKey": "YOUR_API_KEY"
    }
  }
}

Cursor IDE 配置

对于 Cursor IDE，请在 MCP 配置中添加：

{
  "mcpServers": {
    "mcp-hub": {
      "url": "https://www.aimcp.info/api/open/mcp",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

测试连接

你可以使用 curl 测试 HTTP MCP 服务：

# Initialize connection
curl -X POST https://www.aimcp.info/api/open/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "initialize"}'

# List available tools
curl -X POST https://www.aimcp.info/api/open/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}'

# Search for MCPs
curl -X POST https://www.aimcp.info/api/open/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "search_mcp", "arguments": {"keywords": "blockchain", "limit": 5}}}'

MCP 协议实现

支持的方法

HTTP MCP 服务实现了以下 JSON-RPC 2.0 方法：

• initialize：建立连接并获取服务能力
• tools/list：获取可用工具
• tools/call：使用参数执行特定工具

响应格式

所有响应都遵循 JSON-RPC 2.0 规范：

{
  "jsonrpc": "2.0",
  "id": "request_id",
  "result": {
    // Response data
  }
}

错误处理

错误以标准 JSON-RPC 2.0 格式返回：

{
  "jsonrpc": "2.0",
  "id": "request_id", 
  "error": {
    "code": -32603,
    "message": "Error description"
  }
}

服务信息

协议规范

• 协议版本：2024-11-05
• 服务名称：mcp-hub-search
• 版本：1.0.0
• 能力：已启用工具及变更通知

速率限制

• API 请求：每个 API 密钥每小时 20 次请求

CORS 支持

该服务支持跨域请求，并包含以下标头：

• Access-Control-Allow-Origin: *
• Access-Control-Allow-Methods: GET, POST, OPTIONS
• Access-Control-Allow-Headers: Content-Type, Authorization, x-api-key

故障排除

常见问题

1. “0 tools enabled”：请确保 MCP 客户端正确处理 initialize 响应和 capabilities.tools.listChanged 标志。

2. 身份验证错误：请确认 API 密钥有效，并且已包含在 Authorization 标头中。

3. 连接超时：请确认可以访问 https://www.aimcp.info 上的 MCP Hub 服务。

4. CORS 错误：请确保客户端包含正确的标头，并能处理预检 OPTIONS 请求。

调试模式

要进行调试，你可以使用浏览器开发者工具或 curl 等命令行工具检查原始 HTTP 请求和响应。

从基于 stdio 的实现迁移

重要：基于 stdio 的实现已弃用。迁移步骤：

1. 更新 MCP 客户端配置，以使用 HTTP 端点
2. 将基于命令的配置替换为基于 URL 的配置
3. 将身份验证方式从环境变量改为 HTTP 标头
4. 使用提供的 curl 示例测试新连接

服务架构

HTTP MCP 服务集成在 MCP Hub 的 Next.js 应用中：

• 源代码位置：/nextjs/app/api/open/mcp/route.ts
• 生产服务：https://www.aimcp.info/api/open/mcp

贡献

该 HTTP MCP 服务是 MCP Hub 项目的一部分。如需报告问题或参与贡献，请访问主代码仓库。

许可证

MIT 许可证

相关链接

• MCP Hub 网站
• Model Context Protocol 规范
• API 文档