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, exact, source}를 반환합니다. exact: false는 라벨이 폴백(정확한 클래스가 아닌 NAF 섹션)에서 비롯되었음을 의미하므로, 모델은 추측을 사실로 단정하는 대신 적절히 표현을 유보할 수 있습니다.

없는 필드는 null이 아니라 이름으로 표시됩니다. 각 프로필에는 missing 배열이 포함됩니다. "workforce": null이 주어지면 모델이 직원 수를 지어내는 경우가 많지만, "missing": ["workforce"]가 주어지면 등록부에 해당 정보가 없다고 말합니다.

오류는 던져지지 않고 반환됩니다. 실패는 hint가 포함된 JSON으로 반환되므로, 모델은 대화 중에 중단되는 대신 재시도하거나 다시 표현할 수 있습니다.

캐싱은 최적화가 아니라 핵심 기능입니다. 업스트림은 요청 폭주를 속도 제한합니다. 6시간 TTL 캐시(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