Skip to main content
Glama
deenesjakoruzh

MCP Advisor

by istarwyh
npmGitHub
TypeScript
MIT License
469
32
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Советник МКП

Английский |简体中文

Введение

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

Функции

  • Поиск на естественном языке : найдите службы MCP с помощью разговорных запросов
  • Расширенные метаданные : получите подробную информацию о каждой услуге
  • Обновления в реальном времени : всегда синхронизировано с последними службами MCP
  • Простая интеграция : простая настройка для любого совместимого с MCP помощника с искусственным интеллектом
  • Гибридная поисковая система : расширенные возможности поиска, объединяющие векторный поиск и сопоставление текста.
  • Поддержка нескольких поставщиков : поддержка нескольких поставщиков поиска, работающих параллельно.

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

Установка

Самый быстрый способ — интегрировать MCP Advisor через конфигурацию MCP:

{ "mcpServers": { "mcpadvisor": { "command": "npx", "args": ["-y", "@xiaohui-wang/mcpadvisor"] } } }

Добавьте эту конфигурацию в файл настроек MCP вашего AI-помощника:

  • MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %AppData%\Claude\claude_desktop_config.json

Дополнительные методы установки см. в Руководстве по установке .

Демо

Руководство разработчика

Обзор архитектуры

MCP Advisor использует модульную архитектуру с четким разделением задач и принципами функционального программирования:

Основные компоненты

  1. Уровень службы поиска
    • Единый интерфейс поиска и агрегация поставщиков
    • Поддержка нескольких поставщиков поиска, работающих параллельно
    • Настраиваемые параметры поиска (лимит, minПохожие)
  2. Поставщики поиска
    • Meilisearch Provider : поиск векторов с помощью Meilisearch
    • Поставщик GetMCP : поиск API из реестра GetMCP
    • Compass Provider : поиск API из реестра Compass
    • Офлайн-провайдер : гибридный поиск, объединяющий текст и векторы
  3. Гибридная стратегия поиска
    • Интеллектуальное сочетание сопоставления текста и поиска векторов
    • Настраиваемая балансировка веса
    • Интеллектуальные адаптивные механизмы фильтрации
  4. Транспортный уровень
    • Stdio (CLI по умолчанию)
    • SSE (веб-интеграция)
    • Конечные точки REST API

Более подробную документацию по архитектуре см. на сайте ARCHITECTURE.md .

Технические особенности

Расширенные методы поиска

  1. Нормализация вектора
    • Все векторы нормализованы до единичной длины (величина = 1)
    • Обеспечивает последовательные вычисления косинусного подобия
    • Повышает точность поиска, фокусируясь на направлении, а не на величине
  2. Параллельное выполнение поиска
    • Векторный поиск и текстовый поиск выполняются параллельно
    • Использует Promise.all для оптимальной производительности
    • Включаются резервные механизмы, если какой-либо поиск не удался
  3. Взвешенное слияние результатов
    • Настраиваемые веса между векторными и текстовыми результатами
    • По умолчанию: сходство векторов (70%), соответствие тексту (30%)

Система обработки и регистрации ошибок

MCP Advisor реализует надежные системы обработки и регистрации ошибок:

  1. Контекстное форматирование ошибок
    • Стандартизированное обогащение объекта ошибки
    • Сохранение и форматирование трассировки стека
    • Категоризация и стандартизация типов ошибок
  2. Изящная деградация
    • Резервные стратегии с несколькими поставщиками
    • Частичная обработка результата
    • Реакции по умолчанию на критические сбои

Более подробную техническую информацию см. на сайте TECHNICAL_DETAILS.md .

Быстрый старт для разработчиков

Настройка среды разработки

  1. Клонировать репозиторий
  2. Установить зависимости:
    npm install
  3. Настройте переменные среды (см. INSTALLATION.md )

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

import { SearchService } from '@xiaohui-wang/mcpadvisor'; // Initialize search service const searchService = new SearchService(); // Search for MCP servers const results = await searchService.search('vector database integration'); console.log(results);

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

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

  1. Stdio Transport (по умолчанию) — подходит для инструментов командной строки.
  2. SSE Transport — подходит для веб-интеграции
  3. REST Transport — предоставляет конечные точки REST API.

Более подробную информацию о разработке см. на DEVELOPER_GUIDE.md .

Правила внесения вклада

  1. Соблюдайте правила оформления сообщений:
    • Используйте строчные буквы (feat, fix, docs и т. д.)
    • Напишите описательные сообщения в формате предложений.
  2. Обеспечение качества кода:
    • Запуск тестов: npm test
    • Типы проверки: npm run type-check
    • Код линта: npm run lint

Подробные правила внесения взносов см. на сайте CONTRIBUTING.md .

Примеры использования

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

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

"Find MCP servers for natural language processing" "MCP servers for financial data analysis" "E-commerce recommendation engine MCP servers" "MCP servers with image recognition capabilities" "Weather data processing MCP servers" "Document summarization MCP servers"

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

[ { "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 multi-language support.", "github_url": "https://github.com/example/text-processor", "similarity": 0.85 } ]

Дополнительные примеры см. на EXAMPLES.md .

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

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

  1. В соединении отказано
    • Убедитесь, что сервер работает на указанном порту.
    • Проверьте настройки брандмауэра.
  2. Результаты не найдены
    • Попробуйте более общий запрос
    • Проверьте сетевое подключение к API реестра
  3. Проблемы с производительностью
    • Рассмотрите возможность добавления более конкретных поисковых запросов.
    • Проверьте ресурсы сервера (ЦП/память)

Дополнительную информацию по устранению неполадок см. на сайте TROUBLESHOOTING.md .

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

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

  1. Поставщик поиска Compass : извлекает информацию о сервере MCP с помощью API Compass.
  2. Поставщик поиска GetMCP : использует API GetMCP и векторный поиск для семантического соответствия.
  3. Поставщик поиска Meilisearch : использует Meilisearch для быстрого, отказоустойчивого текстового поиска.

Подробную информацию о поставщиках поиска см. на сайте SEARCH_PROVIDERS.md .

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

Подробную документацию API см. в API_REFERENCE.md .

Дорожная карта

MCP Advisor развивается от простой системы рекомендаций до интеллектуальной платформы оркестровки агентов. Наше видение заключается в создании системы, которая не только рекомендует правильные серверы MCP, но и учится на взаимодействиях и помогает агентам динамически планировать и выполнять сложные задачи.

Основные этапы развития

  1. Оптимизация возможностей рекомендаций (2-й-3-й кварталы 2025 г.)
    • Принять отзывы пользователей
    • Уточнить эффективность рекомендаций
    • Ввести больше индексов

Подробную дорожную карту см. на сайте ROADMAP.md .

Тестирование

Используйте инспектор для тестирования:

npx @modelcontextprotocol/inspector

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

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

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Служба поиска и рекомендаций, которая помогает помощникам с искусственным интеллектом находить серверы Model Context Protocol на основе запросов на естественном языке.

  1. Введение
    1. Функции
      1. Навигация по документации
        1. Быстрый старт
          1. Установка
          2. Демо
        2. Руководство разработчика
          1. Обзор архитектуры
          2. Основные компоненты
        3. Технические особенности
          1. Расширенные методы поиска
          2. Система обработки и регистрации ошибок
        4. Быстрый старт для разработчиков
          1. Настройка среды разработки
          2. Использование библиотеки
          3. Варианты транспорта
        5. Правила внесения вклада
          1. Примеры использования
            1. Примеры запросов
            2. Пример ответа
          2. Поиск неисправностей
            1. Общие проблемы
          3. Поставщики поиска
            1. API-документация
              1. Дорожная карта
                1. Основные этапы развития
              2. Тестирование
                1. Лицензия

                  Related MCP Servers

                  • WebSearch-MCP

                    mnhlt
                    A
                    security
                    F
                    license
                    A
                    quality
                    A Model Context Protocol server that enables AI assistants to perform real-time web searches, retrieving up-to-date information from the internet via a Crawler API.
                    Last updated -
                    1
                    44
                    8
                    JavaScript
                    • Apple
                    • Linux

                  • MCP Web Search Tool

                    gabrimatic
                    -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server that provides real-time web search capabilities to AI assistants through pluggable search providers, currently integrated with the Brave Search API.
                    Last updated -
                    3
                    TypeScript
                    MIT License

                  • CodeAlive MCPofficial

                    CodeAlive-AI
                    -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server that enhances AI agents by providing deep semantic understanding of codebases, enabling more intelligent interactions through advanced code search and contextual awareness.
                    Last updated -
                    40
                    Python
                    MIT License
                    • Apple

                  • MCPfinder Server

                    mcpfinder
                    A
                    security
                    A
                    license
                    A
                    quality
                    Enables AI assistants to discover, retrieve details about, and manage MCP (Model Context Protocol) servers that provide additional tools and capabilities on demand.
                    Last updated -
                    4
                    209
                    3
                    JavaScript
                    AGPL 3.0
                    • Linux
                    • Apple

                  View all related MCP servers

                  Appeared in Searches

                  New MCP Servers

                  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/istarwyh/mcpadvisor'

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