Skip to main content
Glama
README.md
# fr-compliance-mcp

[![MCPize](https://mcpize.com/badge/@contact.agentia1984/fr-compliance)](https://mcpize.com/mcp/fr-compliance)

Serveur **MCP** (Model Context Protocol) de **conformite et de KYC France** : validation de TVA intracommunautaire, annonces legales BODACC, procedures collectives et score de risque entreprise.

> 100 % open data (VIES, BODACC/DILA, Etalab) - **gratuit, sans cle d'API, sans inscription**.

## Outils exposes

| Outil | Description |
| --- | --- |
| `fr_vat_compute` | Calcule le numero de TVA intracommunautaire francais (FR + cle + SIREN) depuis un SIREN ou un SIRET, et controle la cle de Luhn. Calcul hors ligne. |
| `eu_vat_validate` | Valide un numero de TVA aupres du service VIES de la Commission europeenne et retourne la raison sociale et l'adresse declarees. |
| `fr_bodacc_search` | Recherche les annonces BODACC par SIREN ou denomination : creations, modifications, ventes, radiations, procedures collectives. |
| `fr_compliance_check` | Controle KYC complet : etat SIRENE, TVA/VIES, procedures collectives, anciennete, signaux de risque, score 0-100 et niveau. |

Chaque outil accepte `response_format` : `markdown` (lecture humaine) ou `json` (traitement programmatique).

## Sources de donnees

- **VIES** - Commission europeenne, verification des numeros de TVA intracommunautaire.
- **BODACC** - Bulletin officiel des annonces civiles et commerciales, DILA, via Opendatasoft.
- **API Recherche d'entreprises** - base SIRENE diffusible, Etalab / data.gouv.fr.

## Installation locale

```bash
npm install
npm run build
node dist/index.js
```

## Connect via MCPize

Utilisez ce serveur MCP instantanément sans installation locale:

```bash
npx -y mcpize connect @contact.agentia1984/fr-compliance --client claude
```

Ou connectez-vous sur: **https://mcpize.com/mcp/fr-compliance**

## Configuration Claude Desktop

```json
{
  "mcpServers": {
    "fr-compliance": {
      "command": "node",
      "args": ["/chemin/vers/fr-compliance-mcp/dist/index.js"]
    }
  }
}
```

## Deploiement heberge (HTTP Streamable)

```bash
TRANSPORT=http node dist/index.js
```

Le serveur ecoute sur `0.0.0.0` et lit `process.env.PORT` (8082 par defaut). Les endpoints MCP sont `POST /mcp` et `POST /`, plus `GET /health`.

## Variables d'environnement

| Variable | Valeur | Role |
| --- | --- | --- |
| `TRANSPORT` | `stdio` (defaut) ou `http` | Choix du transport MCP. |
| `PORT` | entier | Port d'ecoute en mode HTTP. |

## Avertissement

Les resultats proviennent de sources publiques et sont fournis a titre informatif. Ils ne constituent ni un avis juridique, ni une decision de credit, ni un conseil financier.

## Attribution et licence

Donnees BODACC : DILA, Licence Ouverte. Donnees entreprises : Etalab, Licence Ouverte 2.0. Code sous licence MIT.

TDQS

A4.3/5.0

Scored across 4 tools

Disambiguation5/5

Each tool has a distinct, non-overlapping purpose: local VAT calculation, EU VAT validation, BODACC search, and comprehensive KYC check. No ambiguity.

Naming Consistency5/5

All tools follow a consistent pattern of prefix (fr_ or eu_) + noun + verb (vat_compute, vat_validate, bodacc_search, compliance_check).

Tool Count5/5

4 tools is a well-scoped set for French compliance, covering key operations without being too few or too many.

Completeness5/5

The set covers essential compliance functions: VAT computation and validation, legal announcements search, and a full KYC check. No obvious gaps for the domain.

Maintenance

ActivityStale
ResponsivenessNo issues