douanecode-mcp

douanecode-mcp

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

AI エージェント向け EU／フランス税関コード検索（HS、NC8、TARIC） — douanecode.fr を利用した、自然言語による関税分類、関税率、規制動向の監視機能です。DouaneCode API キー（Pro プラン）が必要です。

DouaneCode.fr の公式 MCP サーバーです。AI エージェント（Claude、Cursor、物流／ERP／eコマースのエージェント）に、HS／NC8／TARIC 税関コード検索、関税率、関税動向の監視機能をツールとして提供します。

ビジネスモデル：呼び出しごとに DouaneCode API キーが必要です（Pro プランは年額 99 €、Cabinet ティアは近日提供予定）。このサーバーは薄いラッパーであり、既存のバックエンドが認証、プランごとのレート制限、分析を適用します。

提供するツール

ツール	説明
search_customs_code	自然言語による商品説明 → 候補コード
get_code_details	コードの詳細（名称、階層、単位）
get_duty_rates	関税および措置。原産国の指定は任意です
get_tariff_changes	最近の関税変更（動向監視）

ローカルでの使用方法（Claude Desktop / Claude Code / Cursor）

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

API キー：https://douanecode.fr/compte（Pro プランが必要です）。

開発

pip install -e ".[dev]"
pytest

ホスト型デプロイ

Dockerfile + deploy/k8s.yaml（mcp.douanecode.fr、streamable-http トランスポート）。 マニフェストの注記を参照してください。ホスト型モードでは、クライアントのヘッダーから API キーを読み取る必要があります（TODO）。PyPI で公開されている stdio モードでは、その必要はありません。

配布（市場投入）

1. PyPI（douanecode-mcp）に公開 → すぐに uvx から利用できます。
2. MCP ディレクトリ（mcp.so、Smithery、PulseMCP、Glama）および公式レジストリ registry.modelcontextprotocol.io に登録します。
3. https://douanecode.fr/mcp にインストール方法を説明するページを掲載 → Pro への転換につなげます。