douanecode-mcp

Name: douanecode-mcp
Author: Courouge

本地服务

github.com/Courouge法律与政务014 周前更新

代码仓库

关于 douanecode-mcp

douanecode-mcp 是供 AI Agent 使用的 MCP 服务，可查询欧盟和法国的 HS、NC8 与 TARIC 海关编码。它通过 DouaneCode API 提供编码详情、税率及近期税则变动信息，需使用 Pro API 密钥。

主要功能

01自然语言搜索海关编码
02查询 HS、NC8 和 TARIC 编码详情
03按原产国查询税率和措施
04监测近期税则变动

适用场景

01为产品确定海关归类
02查询特定原产国的关税
03查看近期税则变动

MCP 相关

向 MCP 客户端提供 search_customs_code、get_code_details、get_duty_rates 和 get_tariff_changes 四种工具。调用需要 DouaneCode API 密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "courouge-douanecode": {
      "command": "uvx",
      "args": [
        "douanecode-mcp"
      ],
      "env": {
        "DOUANECODE_API_KEY": "<DOUANECODE_API_KEY>"
      }
    }
  }
}

启动命令uvx douanecode-mcp

需要配置的环境变量

DOUANECODE_API_KEY密钥DouaneCode API key (Pro plan) — get one at https://douanecode.fr/compte

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypidouanecode-mcp0.1.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

douanecode-mcp

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

面向 AI Agent 的欧盟／法国海关编码搜索（HS、NC8、TARIC）——支持自然语言归类、关税税率查询和关税动态监测，由 douanecode.fr 提供支持。需要 DouaneCode API 密钥（Pro 计划）。

DouaneCode.fr 官方 MCP 服务：为 AI Agent（Claude、Cursor、物流／ERP／电商 Agent）提供工具，以搜索 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 模式则无需此操作。

分发（市场推广）

发布到 PyPI（douanecode-mcp）→ 可立即通过 uvx 使用。
在 MCP 目录（mcp.so、Smithery、PulseMCP、Glama）以及官方注册表 registry.modelcontextprotocol.io 中列出。
创建页面 https://douanecode.fr/mcp 说明安装方法 → 转化为 Pro 用户。