mcphub_tools MCP-сервер

Инструменты mcp, работающие на aimcp, найдите mcps, что хотите. Этот сервер позволяет искать MCP Hub для доступных MCP.

Открытый протокол

Этот сервер реализует протокол контекста модели (MCP) . Он действует как сервер MCP, к которому могут подключаться клиенты MCP (например, совместимые помощники ИИ или инструменты разработки).

Related MCP server: MCP Server

Введение

mcphub_tools — это сервер MCP, предназначенный для взаимодействия с MCP Hub . Его основная функция — предоставить инструмент, позволяющий пользователям искать MCP (Model Context Protocols/Servers), зарегистрированные на концентраторе, на основе ключевых слов.

Инструменты

Этот сервер предоставляет следующий инструмент:

`search_mcp_hub`

Описание: Поиск MCP в MCP Hub.
Схема ввода:
{ "type": "object", "properties": { "keywords": { "type": "string", "description": "Keywords to search for MCPs" } }, "required": ["keywords"] }
Вывод: возвращает строку JSON, содержащую результаты поиска из API MCP Hub.

`get_mcp_info`

Описание: Получает подробную информацию о конкретном MCP.
Схема ввода:
{ "type": "object", "properties": { "id": { "type": "string", "description": "MCP identifier (UUID)" } }, "required": ["id"] }
Вывод: возвращает строку JSON, содержащую подробную информацию об указанном MCP.

Варианты реализации

MCP Hub поддерживает два различных способа реализации MCP-серверов:

1. Стандартный сервер MCP на базе stdio

Это традиционная реализация, в которой сервер MCP взаимодействует с клиентами через стандартный ввод/вывод (stdio). Этот подход идеально подходит для автономных инструментов командной строки, которые могут быть интегрированы с клиентами MCP, такими как Claude Desktop.

Самый простой способ использовать реализацию на основе stdio — через наш опубликованный пакет:

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

2. MCP-сервер на базе HTTP

MCP Hub также предоставляет реализацию на основе HTTP, которая позволяет помощникам AI и другим инструментам подключаться к серверу MCP по HTTP. Это реализовано в API MCP Hub в /api/open/v1/streamable .

Конечная точка HTTP доступна по адресу:

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

Использование

Предпосылки

Для реализации на основе stdio установлены Node.js и npm (или pnpm/yarn).
API-ключ от MCP Hub ( https://www.aimcp.info ).

Как получить API-ключ

Перейдите по ссылке https://www.aimcp.info .
Зарегистрируйтесь или войдите в систему.
Перейдите в свой профиль или настройки учетной записи.
Найдите возможность сгенерировать или получить свой ключ API.
Или вы можете зайти сюда , чтобы сгенерировать ключ API. ПРИМЕЧАНИЕ: Ключ API имеет ограничение по частоте запросов — 20 в час.

Аутентификация

API MCP требует аутентификации с действительным ключом API. Этот ключ должен быть предоставлен через:

Для реализации на основе stdio: переменная среды MCP_HUB_API_KEY .
Для реализации на основе HTTP: заголовок Authorization как токен носителя.

Authorization: Bearer YOUR_API_KEY

Интеграция с помощниками на основе искусственного интеллекта и клиентами MCP

Конфигурация рабочего стола Клода

Чтобы использовать 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-интерфейс

Этот сервер взаимодействует со следующей конечной точкой API MCP Hub:

Конечная точка: GET https://www.aimcp.info/api/open/v1/search
Аутентификация: требуется токен Bearer в заголовке Authorization с использованием MCP_HUB_API_KEY .
Параметр запроса: keywords (строка)

Использование API MCP на основе HTTP

MCP Hub предоставляет HTTP-сервер MCP в /api/open/v1/streamable , который реализует протокол контекста модели. Это позволяет помощникам и инструментам ИИ искать MCP и напрямую получать информацию MCP.

Этапы подключения

Сначала установите соединение, чтобы получить идентификатор сеанса:

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

Вызовите инструмент с идентификатором сеанса:

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 (компилирует TypeScript в JavaScript в build/ )
Режим наблюдения: pnpm run watch (автоматически перекомпилирует при изменениях)
Тестирование с помощью Inspector: pnpm run inspector (запускает сервер с помощью инструмента MCP Inspector)

Создание собственного сервера MCP на базе stdio

Если вы хотите создать свой собственный сервер MCP на базе stdio, выполните следующие действия:

Настройте свой проект:
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