douanecode-mcp

# douanecode-mcp

mcp-name: io.github.Courouge/douanecode-mcp

**EU/French customs code search (HS, NC8, TARIC) for AI agents** — natural-language
tariff classification, duty rates and regulatory watch, powered by
[douanecode.fr](https://douanecode.fr). Requires a DouaneCode API key (Pro plan).

Serveur MCP officiel de [DouaneCode.fr](https://douanecode.fr) : donne aux
agents IA (Claude, Cursor, agents logistique/ERP/e-commerce) un accès outillé à
la recherche de codes douaniers HS/NC8/TARIC, aux taux de droits et à la veille
tarifaire.

**Modèle économique** : chaque appel exige une clé API DouaneCode (plan Pro,
99 €/an — tier Cabinet à venir). Le serveur est un wrapper mince ; le backend
existant applique authentification, rate limiting par plan et analytics.

## Outils exposés

| Outil | Description |
|---|---|
| `search_customs_code` | Description produit en langage naturel → codes candidats |
| `get_code_details` | Détail d'un code (libellés, hiérarchie, unités) |
| `get_duty_rates` | Droits de douane + mesures, option pays d'origine |
| `get_tariff_changes` | Changements tarifaires récents (veille) |

## Usage local (Claude Desktop / Claude Code / Cursor)

```json
{
  "mcpServers": {
    "douanecode": {
      "command": "uvx",
      "args": ["douanecode-mcp"],
      "env": { "DOUANECODE_API_KEY": "dc_..." }
    }
  }
}
```

Clé API : https://douanecode.fr/compte (plan Pro requis).

## Dev

```bash
pip install -e ".[dev]"
pytest
```

## Déploiement hébergé

`Dockerfile` + `deploy/k8s.yaml` (mcp.douanecode.fr, transport streamable-http).
Voir la note dans le manifeste : le mode hébergé nécessite de lire la clé API
depuis les headers client (TODO) ; le mode stdio publié sur PyPI fonctionne
sans cela.

## Distribution (go-to-market)

1. Publier sur PyPI (`douanecode-mcp`) → utilisable via `uvx` immédiatement.
2. Lister sur les annuaires MCP (mcp.so, Smithery, PulseMCP, Glama) +
   registre officiel `registry.modelcontextprotocol.io`.
3. Page https://douanecode.fr/mcp expliquant l'installation → conversion Pro.