MODEL CONTEXT PROTOCOL · STREAMABLE HTTP

给 AI Agent 的 海关税则引擎

把 HS 归类、行邮归类、税则查询、批量归类能力封装成标准 MCP 工具,豆包 / WorkBuddy / Cursor / 扣子等 Agent 只需配置一个 Bearer Token,即可在对话中直接调用专业归类能力。

可用的工具 (tools)

通过 tools/list 可获取下列工具及参数 schema。

🧭

hs_classify

一般贸易 HS 智能归类:输入中文品名(可带英文/规格),返回推荐 10 位申报编码、8 位税则码、税率与说明。

📦

postal_classify

个人行邮税归类:输入物品名称/金额/数量,返回行邮税号、税率、高档/普通分档与计税价格。

🔎

hs_tariff_query

税则数据检索:按 HS 编码或品名模糊搜索,返回税则品名与最惠国/普通/特惠税率。免签名、不扣配额。

🗂️

hs_batch

批量归类:一次提交多条(≤200)并发处理,trade/postal 双模式,按会员逐条扣配额。

🎁

claim_daily

领取连接器每日免费额度:连接器用户每天可额外领 2000 次,与网页每日领取独立叠加。

三步接入

端点:POST /mcp · 鉴权:Authorization: Bearer <app_key>

1
会员中心 → API 接入获取你的 app_key 作为 Bearer Token(注册即送 10000 次免费额度)。
2
在 Agent 的 MCP 配置里新增一个 Streamable HTTP 服务器,URL 填 https://你的域名/mcp,Header 加 Authorization: Bearer <app_key>
3
让 Agent 调用工具即可。也可用 WorkBuddy 一键连接器(页首下载)导入,免去手写配置。

curl 自测

curl -X POST https://your-domain/mcp \
  -H "Authorization: Bearer <your_app_key>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": {
      "name": "hs_classify",
      "arguments": { "name": "男士全棉针织T恤衫" }
    }
  }'

初始化握手示例(method: initialize),客户端通常自动完成:

{ "jsonrpc": "2.0", "id": 1, "method": "initialize",
  "params": { "protocolVersion": "2024-11-05", "capabilities": {},
              "clientInfo": { "name": "my-agent", "version": "1.0" } } }

额度与计费

注册赠送 10000
网页每日领取 100 次/天
连接器每日额外 2000 次/天
纯税则查询 免费不扣
KB/商品库命中 不扣配额

触发 AI 归类时按会员逐条扣 1 次配额;额度不足时结果里会回传 credits 并提示续费。

限流:单个 app_key 约 60 次 / 60 秒;批量归类单次上限 200 条。用于保护服务稳定,如需更高并发请通过会员中心联系。

常见问题

支持哪些客户端?

任何支持 MCP Streamable HTTP 的客户端:豆包、扣子、Cursor、WorkBuddy、Claude 系列等。Accept 头含 text/event-stream 时以 SSE 单事件应答,否则返回 application/json。

Token 安全吗?

Bearer Token 即你的 app_key,可在会员中心一键重置密钥,旧密钥立即失效。

GET /mcp 打不开?

/mcp 为 JSON-RPC 传输端点,只接受 POST;浏览器访问 /mcp 是本产品页。真正的能力通过 Agent 的 POST 调用触发。