AI导哈

MCP搜索服务

MCP Hub提供的HTTP MCP服务器，通过标准化的HTTP接口实现MCP（模型上下文协议）的搜索和发现功能。

  • by hekmon8
  • 云端部署
  • 2 星标
  • 更新于
在 GitHub 查看 hekmon8/mcp-hub-tools

使用说明

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

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

概述

MCP Hub实施 模型上下文协议（MCP） Next.js应用程序中的HTTP端点，为AI助手和开发工具提供了一种现代且可访问的方式来发现MCP并与之交互 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": "https://example.com/avatar.png",
    "user_avatar_url": "https://example.com/user.png"
  }
}

基于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支持：启用了跨源请求
  • ✅ 错误处理：全面的错误响应

用法

先决条件

如何获取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 旗帜。

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

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

  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