mcphub_tools MCP-сервер

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

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

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

Related MCP server: Glama MCP Server Search

Введение

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. Этот ключ должен быть предоставлен через:

1. Для реализации на основе stdio: переменная среды MCP_HUB_API_KEY .

2. Для реализации на основе HTTP: заголовок Authorization как токен носителя.

Authorization: Bearer YOUR_API_KEY

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

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

Чтобы использовать MCP Hub с Claude Desktop:

1. Найдите файл конфигурации Claude Desktop:

   • Windows: %APPDATA%\claude\config.json

   • macOS: ~/Library/Application Support/claude/config.json или ~/.config/claude/config.json

   • Linux: ~/.config/claude/config.json

2. Добавьте следующую конфигурацию:

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

3. Перезапустите Claude Desktop, чтобы изменения вступили в силу.

4. В своем разговоре вы можете получить доступ к инструментам MCP Hub, набрав «@mcp-hub».

Cline и другие инструменты CLI

Для инструментов на основе командной строки, таких как Cline:

1. Создайте файл конфигурации с именем servers.json в каталоге вашего проекта:

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

2. Запустите инструмент, используя следующую конфигурацию:

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

Для инструментов, использующих файловую конфигурацию (курсор и т. д.)

1. Создайте файл конфигурации:

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

2. Укажите этот файл в настройках вашего инструмента или запустите его с соответствующим параметром конфигурации.

Запуск вручную

Вы также можете запустить сервер на основе 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.

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

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

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

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

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

Разработка и внедрение

Разработка

1. Зависимости установки: pnpm install

2. Сборка: pnpm run build (компилирует TypeScript в JavaScript в build/ )

3. Режим наблюдения: pnpm run watch (автоматически перекомпилирует при изменениях)

4. Тестирование с помощью Inspector: pnpm run inspector (запускает сервер с помощью инструмента MCP Inspector)

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

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

1. Настройте свой проект:

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

2. Создайте свою реализацию сервера:

// 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);

3. Скомпилируйте и запустите свой сервер:

   npx tsc
   node dist/index.js

4. Проверьте свой сервер с помощью инструмента MCP Inspector:

   npx @modelcontextprotocol/inspector

Развертывание

1. Убедитесь, что сервер собран ( pnpm run build ).

2. Каталог build содержит необходимые файлы JavaScript.

3. Сервер можно запустить с помощью node build/index.js или команды mcphub_tools , если пакет установлен соответствующим образом (например, глобально или связан).

4. Настройте клиент/менеджер MCP так, чтобы он указывал на исполняемый файл сервера, и укажите переменную среды MCP_HUB_API_KEY .

Вы также можете опубликовать свой сервер MCP в npm, чтобы другие могли установить и использовать его.