Skip to main content
Glama
deenesjakoruzh
hekmon8

MCP Hub Tools

by hekmon8
OverviewSchemaRelated ServersScoreDiscussions
Remote

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

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

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

  2. В своем разговоре вы можете получить доступ к инструментам 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"
      }
    }
  ]
}

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

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

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

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

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

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

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

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

    npx tsc
node dist/index.js

  2. Проверьте свой сервер с помощью инструмента 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, чтобы другие могли установить и использовать его.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hekmon8/mcp-hub-tools'

If you have feedback or need assistance with the MCP directory API, please join our Discord server