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 分