# 克隆仓库
git clone https://github.com/dcd887/hs-code-mcp-server.git
cd hs-code-mcp-server

# 安装依赖
pip install -r requirements.txt

{
  "mcpServers": {
    "hs-code": {
      "command": "python",
      "args": ["C:/path/to/hs-code-mcp-server/server.py"]
    }
  }
}

用户：帮我查一下纯棉T恤的HS编码
Agent调用 search_hs_code(product_name="纯棉T恤")
返回：
{
  "status": "ok",
  "query": "纯棉T恤",
  "count": 5,
  "results": [
    {
      "hs_code": "6109.1000",
      "name": "棉制T恤衫、汗衫及其他背心",
      "import_tariff": 14,
      "vat_rate": 13,
      "score": 450.5
    },
    ...
  ]
}

用户：进口100台笔记本电脑，CIF单价5000元，算一下税费
Agent调用 calculate_import_tax(hs_code="8471.3090", cif_price=5000, quantity=100)
返回：
{
  "status": "ok",
  "total_cif": 500000,
  "tariff": 0,
  "vat": 65000,
  "total_tax": 65000,
  "tax_rate_overall": 13.0
}

hs-code-mcp-server/
├── server.py              # MCP Server 主程序
├── requirements.txt       # Python 依赖
├── README.md              # 项目说明
├── LICENSE                # MIT 协议
├── .gitignore             # Git 忽略文件
├── data/
│   ├── hs_codes_full.json     # 完整税则数据（8972条）
│   └── hs4_descriptions.json  # 品目描述（1228个）
├── tests/
│   └── test_search.py     # 搜索算法测试
└── examples/
    └── claude_config.json # Claude Desktop 配置示例