io.github.Courouge/douanecode-mcp
EU customs code search (HS, NC8, TARIC): tariff classification and duty rates
Open source Open in the app JSON README (API)
About
EU customs code search (HS, NC8, TARIC): tariff classification and duty rates
Details
- Kind
- MCP servers
- Topic
- Developer tools
- Publisher
- courouge
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.2
- Last push
- 2026-07-21T07:44:20Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 03:01:48
- Updated
- 2026-08-29 03:01:48
- Origin id
io.github.Courouge/douanecode-mcp
README
# 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.