siret-mcp

MCP-сервер для данных французского реестра компаний. Спрашивайте о любой французской компании по названию, SIREN или SIRET и получайте чистый JSON — все коды реестра в нём уже переведены на простой французский.

Официальный реестр выдаёт вам "nature_juridique": "5710", "activite_principale": "62.01Z", "tranche_effectif_salarie": "12". LLM, получив это, либо угадывает, либо галлюцинирует. Этот сервер выдаёт "Société par actions simplifiée (SAS)", "Programmation informatique", "20 à 49 salariés" — вместе с исходным кодом, чтобы ответ можно было проверить.

Никакого API-ключа. Никакого аккаунта.

Установка

Claude Code

claude mcp add siret -- npx -y siret-mcp

Cursor — ~/.cursor/mcp.json:

{
  "mcpServers": {
    "siret": {
      "command": "npx",
      "args": ["-y", "siret-mcp"]
    }
  }
}

Claude Desktop — claude_desktop_config.json, тот же блок, что и для Cursor.

Перезапустите клиент. Вы должны увидеть четыре инструмента.

Related MCP server: INSEE MCP Server

Попробуйте эти запросы

• "По-прежнему ли активен SIREN 552100554 и какова его организационно-правовая форма?"

• "Найди компании-разработчики ПО в Луаре-Атлантической с более чем 20 сотрудниками."

• "Что означает код NAF 43.22A?"

• "Вот SIRET из счёта: 55210055400015 — проверь его и сообщи юридический адрес."

• "Перечисли все подразделения для этого SIREN и отметь, какое из них является головным офисом."

Инструменты

Плюс ресурс siret://health, предоставляющий статистику кэша.

Проектные решения, о которых стоит знать

Коды всегда сопровождаются метками. Каждое поле с кодом возвращает {code, label, source}. exact: false означает, что метка получена из запасного источника (секция NAF, а не точный класс), поэтому модель может подстраховаться, а не выдавать догадку за факт.

Отсутствующие поля называются, а не обнуляются. Каждый профиль содержит массив missing. При "workforce": null модель часто выдумывает численность сотрудников. При "missing": ["workforce"] она говорит, что в реестре этих данных нет.

Ошибки возвращаются, а не выбрасываются. Сбои возвращаются в виде JSON с полем hint, чтобы модель могла повторить попытку или переформулировать запрос, а не оборвать диалог.

Кэширование — это продукт, а не оптимизация. Внешний API ограничивает всплески запросов. Именно кэш с TTL 6 часов (SIRENE_CACHE_TTL_MS) делает сервер пригодным для агентного цикла, который спрашивает об одной и той же компании девять раз.

Четыре инструмента, а не двенадцать. Каждый лишний инструмент стоит контекста вызывающей модели и добавляет способ ошибиться.

Ограничения

• Таблицы кодов неполные. Полный NAF rev. 2 — это ~732 кода, а catégorie juridique — ~300; здесь поставляются распространённые коды плюс запасной вариант, который сам помечает себя как приблизительный (exact: false).

• Основано на recherche-entreprises.api.gouv.fr, а не на INSEE Sirene v3. Отсутствие API-ключа означает мгновенный запуск. Обратная сторона — меньше полей и нет исчерпывающего перечня подразделений.

• Кэш внутрипроцессный. Нормально для локального stdio-сервера, но не подходит для размещённого мультитенантного.

Данные и атрибуция

Данные получены из API Recherche d'Entreprises (DINUM), на основе INSEE SIRENE, по Licence Ouverte. Записи о руководителях могут содержать год рождения. Вы несёте ответственность за использование данных в соответствии с законом.

Разработка

git clone https://github.com/tbellicha/siret-mcp.git
cd siret-mcp
npm install
npm run build
npm test                 # node:test, offline
npm run test:live        # hits the real API
npm run typecheck

Лицензия

MIT © 2026 tbellicha