MCP Hub Tools

MCP集线器工具-HTTP MCP服务器文档

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

概述

协议支持

⚠️ 重要变更：此服务器 仅支持基于HTTP的MCP连接传统的基于stdio的实现已被弃用，取而代之的是更易于访问和可靠的HTTP接口。

引言

mcp-hub-tools 提供与交互的文档和配置 MCP集线器服务器提供标准化的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": "Keywords to search for in MCP names, descriptions, and metadata"
      },
      "limit": {
        "type": "number",
        "description": "Maximum number of results to return (default: 50)",
        "default": 50
      }
    },
    "required": ["keywords"]
  }

• 输出： 返回包含基本MCP信息的搜索结果，包括：

- uuid：MCP的唯一标识符 - name：MCP名称 - brief：简短描述 - clicks：使用统计 - count：找到的结果总数 - keywords：使用的搜索词

get_mcp_detail

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

  {
    "type": "object",
    "properties": {
      "mcp_id": {
        "type": "string",
        "description": "The UUID of the MCP to retrieve details for"
      }
    },
    "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": "",
    "user_avatar_url": ""
  }
}

基于HTTP的MCP服务器

MCP Hub在其Next.js应用程序中提供了一个基于HTTP的现代MCP服务器实现，与传统的基于stdio的方法相比，它具有更高的可靠性和可访问性。服务器通过HTTP使用JSON-RPC 2.0实现模型上下文协议。

服务器终结点

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

支持的交通工具

• HTTP POST：标准JSON-RPC 2.0请求
• 服务器发送事件（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密钥页
4. 为应用程序生成新的API密钥

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

认证

对HTTP MCP服务器的所有请求都需要使用承载令牌进行身份验证 Authorization 头球

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"
    }
  }
}

光标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个工具”：确保您的MCP客户端正确处理 initialize 响应和 capabilities.tools.listChanged 旗帜。

1. 身份验证错误：验证您的API密钥是否有效并包含在 Authorization 头球

1. 连接超时：验证MCP Hub服务器是否位于https://www.aimcp.info是可访问的。

1. 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中心网站
• 模型上下文协议规范
• API文档