Инструменты mcp, работающие на aimcp, найдите mcps, что хотите. Этот сервер позволяет искать MCP Hub для доступных MCP.
Открытый протокол
Этот сервер реализует протокол контекста модели (MCP) . Он действует как сервер MCP, к которому могут подключаться клиенты MCP (например, совместимые помощники ИИ или инструменты разработки).
Введение
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, чтобы другие могли установить и использовать его.