Douanecode Mcp

io.github.Courouge由 GitHub 账号 Courouge 发布v0.1.2更新于 Oct 24, 2026

EU customs code search (HS, NC8, TARIC): tariff classification and duty rates

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

本地 MCP 服务器，让助手通过 douanecode.fr 查询欧盟和法国海关编码（HS、NC8、TARIC）、关税税率及近期税则变动。

可以做什么
用自然语言描述商品，搜索候选海关编码，并查看每个编码的名称、层级和计量单位。查询某个编码的关税和措施，可选指定原产国。查看近期关税变动，用于税则监测。
适用场景
适合进出口商品归类、估算关税成本或跟踪欧盟税则更新时使用，例如物流、ERP 或电商工作流。
运行要求
作为本地进程运行，通常通过 uvx 启动 PyPI 包 douanecode-mcp。需要在 DOUANECODE_API_KEY 环境变量中提供 DouaneCode API 密钥，且需付费 Pro 套餐。需要访问 douanecode.fr 后端的网络连接。
安装前请注意
每次调用都需要 DOUANECODE_API_KEY 密钥，Pro 套餐按每年 99 欧元计费。查询内容会发送到 douanecode.fr 后端，该后端会进行身份验证、按套餐限流并做分析统计。托管模式在从客户端请求头读取密钥方面被说明为尚未完成。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Douanecode Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 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. 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

OutilDescription
search_customs_codeDescription produit en langage naturel → codes candidats
get_code_detailsDétail d'un code (libellés, hiérarchie, unités)
get_duty_ratesDroits de douane + mesures, option pays d'origine
get_tariff_changesChangements 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.

来源：README.md，提交 f491f93

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分