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. Requires a DouaneCode API key (Pro plan).
Serveur MCP officiel de 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)
{
"mcpServers": {
"douanecode": {
"command": "uvx",
"args": ["douanecode-mcp"],
"env": { "DOUANECODE_API_KEY": "dc_..." }
}
}
}
Clé API : https://douanecode.fr/compte (plan Pro requis).
Dev
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)
- Publier sur PyPI (
douanecode-mcp) → utilisable via uvx immédiatement.
- Lister sur les annuaires MCP (mcp.so, Smithery, PulseMCP, Glama) +
registre officiel
registry.modelcontextprotocol.io.
- Page https://douanecode.fr/mcp expliquant l'installation → conversion Pro.