Советник МКП

Консультант и установка MCP

Установка НПМ

Вы можете установить MCP Advisor напрямую из npm:

# Using npm
npm install @xiaohui-wang/mcpadvisor

# Using yarn
yarn add @xiaohui-wang/mcpadvisor

# Using pnpm
pnpm add @xiaohui-wang/mcpadvisor

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

Как инструмент командной строки

# Run directly with npx
npx @xiaohui-wang/mcpadvisor

# Or if installed globally
mcpadvisor

Как библиотека

import { SearchService } from '@xiaohui-wang/mcpadvisor';

// Initialize the search service
const searchService = new SearchService();

// Search for MCP servers
const results = await searchService.search('vector database integration');
console.log(results);

Опыт работы консультантом MCP

Что это?

MCP Advisor — это служба обнаружения и рекомендаций, которая помогает вам исследовать серверы Model Context Protocol. Она действует как интеллектуальный гид, который помогает помощникам ИИ находить и понимать доступные службы MCP на основе запросов на естественном языке , что упрощает обнаружение и использование правильных инструментов для конкретных задач.

Функции

Умный поиск : найдите службы MCP, используя запросы на естественном языке
Расширенные метаданные : получите подробную информацию о каждой услуге
Обновления в реальном времени : всегда в курсе последних услуг MCP
Простая интеграция : простая интеграция с любым совместимым с MCP помощником с искусственным интеллектом.
Несколько поисковых бэкэндов :
- OceanBase : Высокопроизводительная векторная база данных для семантического поиска
- Meilisearch : быстрая, легкая поисковая система с толерантностью к опечаткам
Модульная архитектура : четкое разделение задач по поддержке и расширяемости.

Архитектура

Поток данных

Быстрый старт

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

Клонировать репозиторий

или

Использовать npx

Установка

Для Claude Desktop отредактируйте файл claude_desktop_config.json :

MacOS/Linux

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Окна

code $env:AppData\Claude\claude_desktop_config.json

Варианты транспорта

MCP Advisor поддерживает два метода транспортировки:

1. Стандартный транспорт (по умолчанию)

Используйте это для инструментов командной строки и прямой интеграции.

Добавьте в конфигурацию MCP вашего помощника на основе искусственного интеллекта следующие функции обнаружения сервисов:

{
"mcpServers": {
   "mcp-advisor": {
      "command": "npx",
      "args": [
         "-y",
         "/path/to/repo/build/index.js"
      ]
   }
}
}

2. Транспорт SSE (HTTP-сервер)

Используйте это для удаленных серверов или веб-интеграций. Запустите сервер с помощью:

# Start with SSE transport on port 3000
OCEANBASE_URL=mysql://xxx TRANSPORT_TYPE=sse SERVER_PORT=3000 ENABLE_FILE_LOGGING=true node build/index.js

Переменные среды для конфигурации SSE:

TRANSPORT_TYPE : Установите значение sse для использования транспорта SSE (по умолчанию — stdio)
SERVER_PORT : порт HTTP-сервера (по умолчанию: 3000)
SERVER_HOST : Хост HTTP-сервера (по умолчанию: localhost)
SSE_PATH : путь к конечной точке SSE (по умолчанию: /sse)
MESSAGE_PATH : Путь к конечной точке сообщений (по умолчанию: /messages)

Подключитесь к серверу с помощью:

Конечная точка SSE: http://localhost:3000/sse
Конечная точка сообщений: http://localhost:3000/messages?sessionId=<SESSION_ID>
Проверка работоспособности: http://localhost:3000/health

3. ОТДЫХ Транспорт

TRANSPORT_TYPE=rest SERVER_PORT=3000 ENABLE_FILE_LOGGING=true node build/index.js

Примеры

Примеры запросов

Вот несколько примеров запросов, которые вы можете использовать с MCP Advisor:

"Find an MCP server for natural language processing"
"MCP server for financial data analysis"
"Recommendation engine MCP server for e-commerce"
"MCP server with image recognition capabilities"
"Weather data processing MCP server"
"Document summarization MCP server"

Пример ответа

[
  {
    "title": "NLP Toolkit",
    "description": "Comprehensive natural language processing toolkit with sentiment analysis, entity recognition, and text summarization capabilities.",
    "github_url": "https://github.com/example/nlp-toolkit",
    "similarity": 0.92
  },
  {
    "title": "Text Processor",
    "description": "Efficient text processing MCP server with multilingual support.",
    "github_url": "https://github.com/example/text-processor",
    "similarity": 0.85
  }
]

Поиск неисправностей

Общие проблемы

В соединении отказано
- Убедитесь, что сервер работает на указанном порту.
- Проверьте настройки брандмауэра.
- Проверьте правильность адреса хоста.
Результаты не найдены
- Попробуйте более общий запрос
- Проверьте сетевое подключение к API реестра
- Проверьте правильность настройки конечных точек API.
Сбои в подключении SSE
- Увеличьте настройки времени ожидания клиента
- Проверьте журналы сервера на наличие сообщений об ошибках.
- При подключении через браузер убедитесь в правильности конфигурации CORS.
Проблемы с производительностью
- Рассмотрите возможность добавления более конкретных поисковых запросов.
- Проверьте ресурсы сервера (ЦП/память)
- Реализуйте кэширование при частом выполнении однотипных запросов

Журналы

Для подробного устранения неполадок проверьте журналы в каталоге logs . Включите отладочное ведение журнала с помощью:

DEBUG=true node build/index.js

Переменные среды

MCP Advisor можно настроить с помощью следующих переменных среды:

Переменная	Описание	По умолчанию	Необходимый
`TRANSPORT_TYPE`	Метод транспортировки ( `stdio` , `sse` , `rest` )	`stdio`	Нет
`SERVER_PORT`	Порт HTTP-сервера для транспорта SSE/REST	`3000`	Нет
`SERVER_HOST`	Хост HTTP-сервера для транспорта SSE/REST	`localhost`	Нет
`SSE_PATH`	Путь конечной точки SSE	`/sse`	Нет
`MESSAGE_PATH`	Путь конечной точки сообщений	`/messages`	Нет
`ENDPOINT`	Путь конечной точки REST	`/rest`	Нет
`DEBUG`	Включить отладочное ведение журнала	`false`	Нет
`ENABLE_FILE_LOGGING`	Включить ведение журнала в файлах	`false`	Нет
`LOG_LEVEL`	Уровень журнала (отладка, информация, предупреждение, ошибка)	`info`	Нет
`ENABLE_MEILISEARCH_TESTS`	Включить тесты Meilisearch	`false`	Нет
`VECTOR_ENGINE_TYPE`	Тип векторного двигателя ( `memory` , `oceanbase` , `meilisearch` )	`memory`	Нет

Поставщики поиска

MCP Advisor поддерживает несколько поставщиков поиска, которые можно использовать одновременно:

1. Поставщик поиска Compass

Использует Compass API для получения информации о сервере MCP.

2. Поставщик поиска GetMCP

Использует API GetMCP и векторный поиск для семантического сопоставления.

3. Поисковый провайдер Meilisearch

Использует Meilisearch для быстрого и толерантного к опечаткам поиска текста.

Конфигурация Meilisearch

Интеграцию Meilisearch можно настроить в src/config/meilisearch.ts :

export const MEILISEARCH_CONFIG = {
  host: 'https://ms-1c8c8f2b0bc7-1.lon.meilisearch.io',
  apiKey: '', // API key with read permissions
  indexName: 'mcp_server_info_from_getmcp_io'
};

API-документация

Конечные точки REST API

ПОЛУЧИТЬ `/health`

Конечная точка проверки работоспособности.

Ответ:

{
  "status": "ok",
  "version": "1.0.0"
}

ПОЛУЧИТЬ `/sse`

Конечная точка Server-Sent Events для установления соединения.

Параметры запроса:

Никто

Ответ:

Устанавливает соединение SSE

ПОСТ `/messages`

Конечная точка для отправки сообщений по установленному соединению SSE.

Параметры запроса:

sessionId (строка, обязательно): идентификатор сеанса соединения SSE.

Текст запроса:

{
  "jsonrpc": "2.0",
  "method": "callTool",
  "params": {
    "name": "recommend-mcp-servers",
    "arguments": {
      "query": "financial data analysis"
    }
  },
  "id": "1"
}

Ответ:

{
  "jsonrpc": "2.0",
  "result": {
    "content": [
      {
        "title": "Financial Analytics MCP",
        "description": "Comprehensive financial data analysis toolkit",
        "github_url": "https://github.com/example/financial-mcp",
        "similarity": 0.95
      }
    ]
  },
  "id": "1"
}

ПОСТ `/rest`

Конечная точка REST API для прямых запросов (при использовании транспорта REST).

Текст запроса:

{
  "jsonrpc": "2.0",
  "method": "callTool",
  "params": {
    "name": "recommend-mcp-servers",
    "arguments": {
      "query": "financial data analysis"
    }
  },
  "id": "1"
}

Ответ: То же, что и конечная точка /messages .

Тест

с инспектором

 npx @modelcontextprotocol/inspector

Лицензия

Лицензия MIT. Подробную информацию см. в файле LICENSE .

Integrations