mcphub_tools MCP 服务器

由 aimcp 提供支持的 McP 工具，助您轻松找到所需的 MCP。此服务器支持在 MCP Hub 中搜索可用的 MCP。

开放协议

该服务器实现了模型上下文协议 (MCP) 。它充当 MCP 服务器，可供 MCP 客户端（例如兼容的 AI 助手或开发工具）连接。

Related MCP server: MCP Server

介绍

mcphub_tools是一个用于与MCP Hub交互的 MCP 服务器。其主要功能是提供一个工具，允许用户根据关键字搜索在 Hub 上注册的 MCP（模型上下文协议/服务器）。

工具

该服务器提供以下工具：

`search_mcp_hub`

**描述：**在 MCP Hub 上搜索 MCP。

输入模式：

{
  "type": "object",
  "properties": {
    "keywords": {
      "type": "string",
      "description": "Keywords to search for MCPs"
    }
  },
  "required": ["keywords"]
}

**输出：**返回包含来自 MCP Hub API 的搜索结果的 JSON 字符串。

`get_mcp_info`

**描述：**获取有关特定 MCP 的详细信息。

输入模式：

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "MCP identifier (UUID)"
    }
  },
  "required": ["id"]
}

**输出：**返回包含指定 MCP 详细信息的 JSON 字符串。

实施选项

MCP Hub 支持两种不同的方式实现 MCP 服务器：

1. 基于 stdio 的标准 MCP 服务器

这是 MCP 服务器通过标准输入/输出 (stdio) 与客户端通信的传统实现方式。这种方法非常适合可与 Claude Desktop 等 MCP 客户端集成的独立命令行工具。

使用基于 stdio 的实现的最简单方法是通过我们发布的包：

# Using npx (recommended for most users)
npx @aimcp/tools

# Using uvx (faster startup)
uvx @aimcp/tools

2. 基于 HTTP 的 MCP 服务器

MCP Hub 还提供了基于 HTTP 的实现，允许 AI 助手和其他工具通过 HTTP 连接到 MCP 服务器。该实现在 MCP Hub 的 API 中，位于/api/open/v1/streamable 。

HTTP 端点位于：

https://mcp.aimcp.info/api/open/v1/streamable

用法

先决条件

为基于 stdio 的实现安装 Node.js 和 npm（或 pnpm/yarn）。
来自 MCP Hub 的 API 密钥（ https://www.aimcp.info ）。

如何获取 API 密钥

转到https://www.aimcp.info 。
注册或登录。
导航到您的个人资料或帐户设置。
寻找生成或检索 API 密钥的选项。
或者您可以访问此处生成 API 密钥。注意：API 密钥的请求速率限制为每小时 20 个。

验证

MCP API 需要使用有效的 API 密钥进行身份验证。此密钥必须通过以下方式提供：

对于基于 stdio 的实现：环境变量MCP_HUB_API_KEY 。
对于基于 HTTP 的实现： Authorization标头作为 Bearer 令牌。

Authorization: Bearer YOUR_API_KEY

与 AI 助手和 MCP 客户端集成

Claude桌面配置

要将 MCP Hub 与 Claude Desktop 结合使用：

找到您的 Claude Desktop 配置文件：
- Windows： %APPDATA%\claude\config.json
- macOS： ~/Library/Application Support/claude/config.json或~/.config/claude/config.json
- Linux： ~/.config/claude/config.json
添加以下配置：

{
  "mcpServers": {
    "mcp-hub": {
      "command": "npx",
      "args": ["@aimcp/tools"],
      "environment": {
        "MCP_HUB_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

重新启动 Claude Desktop 以应用更改。
在对话中，您可以通过输入“@mcp-hub”来访问 MCP Hub 工具。

Cline 和其他 CLI 工具

对于基于命令行的工具（例如 Cline）：

在您的项目目录中创建一个名为servers.json的配置文件：

{
  "servers": [
    {
      "name": "mcp-hub-tools",
      "command": ["npx", "@aimcp/tools"],
      "environment": {
        "MCP_HUB_API_KEY": "YOUR_API_KEY"
      }
    }
  ]
}

参考此配置启动该工具：

cline --mcp-servers-config ./servers.json

对于支持远程 MCP 服务器的工具

一些较新的 MCP 客户端支持直接 HTTP 连接。请使用以下方式配置它们：

{
  "mcpServers": {
    "mcp-hub-http": {
      "url": "https://mcp.aimcp.info/api/open/v1/streamable",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

对于使用基于文件配置的工具（光标等）

创建配置文件：

{
  "mcpServers": {
    "mcp-hub": {
      "command": "npx",
      "args": ["@aimcp/tools"],
      "environment": {
        "MCP_HUB_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

在您的工具设置中引用此文件或使用适当的配置参数启动。

手动运行

您还可以手动运行基于 stdio 的服务器进行测试（确保在您的环境中设置了MCP_HUB_API_KEY ）：

export MCP_HUB_API_KEY="YOUR_API_KEY_HERE"
npx @aimcp/tools

API接口

该服务器与以下 MCP Hub API 端点交互：

端点： GET https://www.aimcp.info/api/open/v1/search
**身份验证：**需要使用MCP_HUB_API_KEY在Authorization标头中输入 Bearer 令牌。
查询参数： keywords （字符串）

使用基于 HTTP 的 MCP API

MCP Hub 在/api/open/v1/streamable提供了一个基于 HTTP 的 MCP 服务器，该服务器实现了模型上下文协议 (MCP Protocol)。这使得 AI 助手和工具能够直接搜索 MCP 并获取 MCP 信息。

连接步骤

首先建立连接以获取会话ID：

GET /api/open/v1/streamable
Authorization: Bearer YOUR_API_KEY

回复：

{
  "success": true,
  "sessionId": "194830ab-eb0b-4d17-a574-af96705276c2",
  "message": "Connection established. Use this sessionId for subsequent calls."
}

使用会话 ID 调用工具：

POST /api/open/v1/streamable?sessionId=194830ab-eb0b-4d17-a574-af96705276c2
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "jsonrpc": "2.0",
  "method": "callTool",
  "params": {
    "name": "search_mcp_hub",
    "arguments": {
      "keywords": "example"
    }
  },
  "id": "call-1"
}

开发与部署

发展

安装依赖项： pnpm install
构建： pnpm run build （在build/中将 TypeScript 编译为 JavaScript）
监视模式： pnpm run watch （发生更改时自动重新编译）
使用 Inspector 进行测试： pnpm run inspector （使用 MCP Inspector 工具运行服务器）

创建你自己的基于 stdio 的 MCP 服务器

如果您想创建自己的基于 stdio 的 MCP 服务器，请按照以下步骤操作：

设置您的项目：

mkdir my-mcp-server
cd my-mcp-server
npm init -y
npm install @modelcontextprotocol/sdk

创建您的服务器实现：

// index.ts
import { Server } from '@modelcontextprotocol/sdk/server';
import { 
  CallToolRequestSchema, 
  ListToolsRequestSchema,
  McpError,
  ErrorCode
} from '@modelcontextprotocol/sdk/types';
import { StdioTransport } from '@modelcontextprotocol/sdk/transports/stdio';

// Create an MCP server instance
const server = new Server(
  {
    name: "my-mcp-server",
    version: "1.0.0"
  },
  {
    capabilities: {
      tools: {},
    }
  }
);

// Set up tool handlers
server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [
    {
      name: 'my_tool',
      description: 'Description of my tool',
      inputSchema: {
        type: 'object',
        properties: {
          param1: {
            type: 'string',
            description: 'Description of param1',
          },
        },
        required: ['param1'],
      },
    },
  ],
}));

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  // Extract tool name and arguments
  const toolName = request.params.name;
  const args = request.params.arguments;
  
  if (toolName === 'my_tool') {
    // Validate arguments
    if (typeof args !== 'object' || args === null || typeof args.param1 !== 'string') {
      throw new McpError(
        ErrorCode.InvalidParams,
        'Invalid arguments. Requires "param1" (string).'
      );
    }
    
    try {
      // Implement your tool logic here
      const result = `Processed: ${args.param1}`;
      
      return {
        content: [
          {
            type: 'text',
            text: result,
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `Error: ${error instanceof Error ? error.message : String(error)}`,
          },
        ],
        isError: true,
      };
    }
  } else {
    throw new McpError(
      ErrorCode.MethodNotFound,
      `Unknown tool: ${toolName}`
    );
  }
});

// Connect the server to stdin/stdout
const transport = new StdioTransport();
server.connect(transport).catch(console.error);

编译并运行你的服务器：
```
npx tsc
node dist/index.js
```
使用 MCP Inspector 工具测试您的服务器：
```
npx @modelcontextprotocol/inspector
```

部署

确保服务器已构建（ pnpm run build ）。
build目录包含必要的 JavaScript 文件。
如果软件包安装得当（例如全局或链接），则可以使用node build/index.js或命令mcphub_tools运行服务器。
配置您的 MCP 客户端/管理器以指向服务器可执行文件并提供MCP_HUB_API_KEY环境变量。

您还可以将您的 MCP 服务器发布到 npm，以便其他人可以安装和使用它。

MCP Hub Tools