MCP Бизнес Поиск

Этот MCP (модуль подключения API) позволяет вам взаимодействовать с API поиска по бизнесу, предоставляемым data.gouv.fr.

Описание

API поиска предприятий позволяет вам искать и находить французские компании. Предлагает два типа поиска:

Текстовый поиск (имя, адрес, руководители и выборные должностные лица)
Географический поиск

Функции

MCP позволяет:

Поиск компаний по разным критериям
Фильтровать результаты по нескольким параметрам
Доступ к важной информации о компании (название, SIREN, SIRET, код NAF)
Выполнять географический поиск вокруг точки со следующими параметрами:
- Широта и долгота точки поиска
- Радиус поиска (до 50км)
- Фильтры активности (код NAF, раздел активности)
- Результаты пагинации

Источник

Этот MCP основан на официальном API data.gouv.fr: Business Search API

Ограничения

API имеет некоторые ограничения:

Не предоставляет доступ к предшественникам и преемникам учреждения
Не разрешает доступ к компаниям, не подлежащим распространению
Не разрешает доступ к компаниям, которым было отказано в регистрации в RCS.
Географический радиус поиска ограничен максимумом в 50 км.

Технические ограничения

Лимит 7 вызовов в секунду
Доступность: 100% за последний месяц
Доступ: открыт для всех

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

Как пользователь

Самый простой способ использовать этот MCP — через npx :

npx mcp-recherche-entreprises

Как разработчик

Установка зависимостей:

npm install

Проект сборки:

npm run build

Эта команда:

Компилировать файлы TypeScript в JavaScript
Поместите их в папку dist/
Сделать файлы JavaScript исполняемыми

Запускать :

Чтобы запустить сервер в режиме разработки с помощью MCP Inspector (рекомендуется для разработки):

npm run dev

Чтобы запустить сервер без Инспектора:

npm start

MCP Inspector предоставляет графический интерфейс для тестирования и отладки запросов MCP в режиме реального времени.

Использовать с курсором

Чтобы использовать этот MCP в Cursor, добавьте следующую конфигурацию в файл .cursor/settings.json :

{
  "mcpServers": {
    "recherche-entreprises": {
      "command": "npx mcp-recherche-entreprises"
    }
  }
}

Эта конфигурация позволит Cursor автоматически использовать этот MCP для бизнес-поиска.

Ресурсы MCP для участников

Официальная документация

Инструменты разработки

MCP TypeScript SDK
MCP Inspector — инструмент отладки и анализа

Лучшие практики

Используйте TypeScript SDK для реализации
Соблюдайте соглашения о коде проекта
Реализуйте надежную обработку ошибок
Четко документируйте API
Поддерживать совместимость с будущими версиями

Тестирование и отладка

Использование инспектора для отладки
Реализовать модульные тесты
Проверить соответствие спецификации MCP
Анализируйте производительность с помощью соответствующих инструментов

Лицензия

Данный проект лицензирован по лицензии MIT. Подробную информацию смотрите в файле ЛИЦЕНЗИЯ .

Вклад

Ваши вклады приветствуются! Более подробную информацию о том, как внести свой вклад в этот проект, можно найти в нашем руководстве по внесению взносов .

MCP Recherche d'entreprises