MCPfinder Server

MCPfinder 🔧🤖 ( @mcpfinder/server )

Познакомьтесь с самым простым способом форсировать кодирование и агентов ИИ с помощью MCP — «API для ИИ». MCPfinder позволяет языковым моделям искать и устанавливать новые возможности по требованию через клиентские приложения, поддерживающие протокол MCP. Не требуется кодирование или ручная настройка.

Магазин приложений для агентов

Пользователи могут запрашивать инструменты, которых у ИИ пока нет, или ИИ может автономно расширять свои собственные возможности, обнаруживая соответствующие серверы MCP. От генераторов кода и анализаторов данных до специализированных инструментов знаний, MCPfinder действует как карта и набор инструментов для ИИ — преобразуя статические модели в развивающиеся, ищущие возможности агенты, которые становятся все более мощными с каждым взаимодействием.

Инструменты Plug-and-Play для LLM

Это приложение Node.js реализует сервер MCP (Model Context Protocol), разработанный для локального запуска вместе с клиентами MCP (такими как Cursor, Claude Desktop, Windsurf). Оно предоставляет инструменты, которые позволяют ИИ внутри клиента взаимодействовать с экосистемой MCP.

В частности, он позволяет ИИ-помощнику:

1. Найдите доступные серверы MCP, зарегистрированные в центральном реестре MCPfinder (через search_mcp_servers ).
2. Получить сведения о конкретных серверах (через get_mcp_server_details ).
3. Управление локальным файлом конфигурации сервера MCP клиентского приложения (добавление/обновление через add_mcp_server_config , удаление через remove_mcp_server_config ).

Примечание для агентов ИИ: этот сервер является основным интерфейсом для поиска и включения новых инструментов и возможностей, запрашиваемых пользователем, если они еще не доступны в текущем наборе инструментов MCP. Используйте search_mcp_servers в первую очередь, когда пользователь запрашивает возможность, которой у вас нет.

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

Запустите в терминале интерактивный инструмент настройки для автоматического обновления файла конфигурации MCP:

Эта команда проведет вас через выбор вашего клиента (Cursor, VS Code, Claude и т. д.) и добавит необходимую запись mcpfinder в правильный файл конфигурации (например, ~/.cursor/mcp.json ). См. «Запуск из исходного кода» и «Команды и параметры» для получения более подробной информации, если вы работаете напрямую с исходным кодом.

Ручная настройка

Чтобы вручную настроить клиент MCP, вам необходимо создать или изменить его файл конфигурации JSON, включив в него запись для mcpfinder .

Структура файла конфигурации:

Примечание: для Visual Studio Code ( settings.json ) ключом верхнего уровня для конфигураций MCP должно быть servers вместо mcpServers .

Запуск из источника

• Клонируйте этот репозиторий, например, git clone https://github.com/mcpfinder/server
• Запустите node index.js для режима Stdio или node index.js --http для режима HTTP.

Команды и параметры

При запуске из источника ( node index.js ) скрипт можно вызвать несколькими способами:

Запуск сервера (поведение по умолчанию): если команда не указана, index.js запускает сервер MCP.

• Режим Stdio (по умолчанию):
  node index.js
• HTTP-режим:
  node index.js --http
  • --port <number> : укажите порт для режима HTTP (по умолчанию: 6181 или переменная окружения MCP_PORT ).
  • --api-url <url> : указать URL-адрес API реестра MCPfinder, используемый инструментами (по умолчанию: https://mcpfinder.dev или переменная окружения MCPFINDER_API_URL ).

Выполнение команд:

• install : запустить интерактивную установку для настройки клиентского приложения.
  node index.js install
• register : для издателей серверов, чтобы зарегистрировать свой пакет сервера MCP в реестре MCPFinder.
  node index.js register

Получение помощи:

• --help : Отобразить справочное сообщение с подробным описанием команд и параметров.
  node index.js --help

Сервер использует следующие переменные среды:

• MCPFINDER_API_URL : Базовый URL для API реестра MCPfinder. По умолчанию https://mcpfinder.dev .
• MCP_PORT (только режим HTTP): Номер порта, который будет прослушивать сервер. По умолчанию 6181 .

Предоставленные инструменты

Этот сервер MCP предоставляет подключенному помощнику на базе искусственного интеллекта следующие инструменты:

1. search_mcp_servers

• Описание: Поиск в реестре MCPfinder доступных серверов MCP. Это основной инструмент для обнаружения и доступа к новым инструментам, методам, функциям или возможностям.
• Схема ввода:
  • query (строка, необязательно): Ключевые слова для поиска в названии или описании инструмента.
  • tag (строка, необязательно): Конкретный тег для фильтрации.
• Вывод: список соответствующих сводок сервера (server_id, имя, описание, URL, теги). Типичный следующий шаг — использовать get_mcp_server_details для получения дополнительной информации или напрямую add_mcp_server_config для установки.

⚠️ Примечание: в настоящее время реестр содержит несколько сотен серверов, которые могут быть запущены локально с помощью npx в режиме stdio без необходимости переменных среды для базовой работы. Будущие обновления расширят поддержку, включив более широкий спектр серверов, включая платные и коммерческие варианты, требующие ключей среды.

2. get_mcp_server_details

• Описание: Извлекает подробную информацию о конкретном сервере MCP из реестра, включая его полный манифест и основные рекомендации по установке (команда, переменные среды). Используйте это после нахождения server_id через search_mcp_servers , чтобы получить больше информации перед его потенциальным добавлением.
• Схема ввода:
  • id (строка, обязательно ): уникальный server_id MCPfinder, полученный из search_mcp_servers .
• Вывод: Подробный манифест сервера и подсказки по установке. Следующий шаг — использовать add_mcp_server_config для установки сервера.

3. add_mcp_server_config

• Описание: Добавляет или обновляет конфигурацию для определенного сервера MCP в локальном файле конфигурации клиентского приложения (например, Cursor's ~/.cursor/mcp.json ). Необходимо указать либо client_type ИЛИ config_file_path .
• Схема ввода:
  • server_id (строка, обязательно ): уникальный идентификатор для записи конфигурации сервера (идентификатор MCPfinder, полученный из search_mcp_servers ).
  • client_type (строка, необязательно): Тип клиентского приложения (известные типы определяются динамически, примеры: 'cursor' , 'claude' , 'windsurf' ). Взаимоисключающий с config_file_path . Используйте это для стандартных клиентских установок.
  • config_file_path (строка, необязательно): Абсолютный путь или путь, начинающийся с ~ (домашний каталог) к целевому файлу конфигурации JSON (например, /path/to/custom/mcp.json или ~/custom/mcp.json ). Взаимоисключающий с client_type . Используйте это для нестандартных местоположений или пользовательских клиентов.
  • mcp_definition (объект, необязательно): определяет конфигурацию сервера. Если пропущено или отсутствуют некоторые поля, значения по умолчанию будут извлечены из реестра MCPfinder на основе server_id .
    • command (массив строк, необязательно): команда и ее аргументы (например, ["npx", "-y", "my-mcp-package"] ). Если они опущены или если ниже указаны только env / workingDirectory , команда по умолчанию извлекается из реестра.
    • env (объект, необязательно): переменные среды (например, {"API_KEY": "YOUR_KEY"} ). Объединяются со значениями по умолчанию, если command пропущена.
    • workingDirectory (строка, необязательно): рабочий каталог для процесса сервера. Объединяется с defaults, если command пропущена.
• Вывод: сообщение об успешном выполнении или ошибке.
• Примечание: Ключ, используемый для хранения конфигурации этого сервера в файле JSON (в mcpServers или servers ), автоматически генерируется на основе зарегистрированного URL сервера (полученного через server_id ). Предоставленный server_id используется в качестве резервного варианта, если из URL не может быть получен подходящий ключ. Инструмент автоматически определяет, следует ли использовать mcpServers или servers в качестве ключа верхнего уровня на основе существующей структуры файла, по умолчанию mcpServers .

4. remove_mcp_server_config

• Описание: Удаляет конфигурацию для определенного сервера MCP из локального файла конфигурации клиентского приложения. Необходимо указать либо client_type ИЛИ config_file_path . Указанный server_id должен соответствовать имени ключа конфигурации, использованному при добавлении сервера (которое обычно выводится из URL сервера, см. примечание add_mcp_server_config ).
• Схема ввода:
  • server_id (строка, обязательно ): уникальный идентификатор (имя ключа конфигурации) записи конфигурации сервера, которую необходимо удалить.
  • client_type (строка, необязательно): Тип клиентского приложения (известные типы определяются динамически, примеры: 'cursor' , 'claude' , 'windsurf' ). Взаимоисключающий с config_file_path .
  • config_file_path (строка, необязательно): Абсолютный путь или путь, начинающийся с ~ (домашний каталог) к целевому файлу конфигурации JSON. Взаимоисключающий с client_type .
• Вывод: сообщение об успешном завершении или ошибке, указывающее, была ли запись найдена и удалена.

Соображения безопасности

Инструменты add_mcp_server_config и remove_mcp_server_config изменяют файлы на локальной системе пользователя. Сам этот сервер не выполняет проверки разрешений; он полностью полагается на вызывающего клиента для обеспечения безопасности.

Внося вклад

Для участия обращайтесь: mcpfinder(dot}dev[at}domainsbyproxy{dot]com

Лицензия

Данный проект лицензирован в соответствии с лицензией GNU Affero General Public License v3.0 — подробности см. в файле LICENSE .

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