八达通特价申请 MCP Server

基于第三方签名鉴权，给销售在 WorkBuddy / Cursor 里 新增、修改未报价、查询 特价申请（crm/customerInquiry）。不含报价。

支持通过 npx @shujun0714/inquiry-mcp 一键启动（Node 启动器 + Python MCP 实现）。

功能

| Tool | 说明 | |------|------| | get_inquiry_scope | 当前账号 0W2L 数据范围 + 查老客户条件 | | search_deal_customers | 权限范围内私海成交客户 | | search_products | 已启用小包 / FBA 产品 | | parse_fba_entries | 解析 FBA 明细（口述/表格/xlsx）；缺列先确认映射；图片上传 OSS 0044 | | list_inquiries | 权限范围内特价申请列表 | | get_inquiry | 详情（只读） | | save_inquiry | 新增或改未报价单；confirm=true 才写库；FBA 明细图片一并上传 |

推荐接入

{
  "mcpServers": {
    "bdt-inquiry": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "--registry",
        "https://registry.npmjs.org/",
        "@shujun0714/[email protected]"
      ],
      "env": {
        "BDT_ERP_BASE_URL": "https://erptestdev.8dt.com/supply/",
        "BDT_ERP_SECRET": "your-secret",
        "BDT_ERP_CLIENT_ID": "your-client-id",
        "BDT_ERP_CU_ID": "your-cu-id",
        "BDT_ERP_USER_ID": "销售人员ID",
        "BDT_ERP_DC": "supplytest",
        "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

Windows 把 command 改成 npx.cmd，并去掉 PATH。BDT_ERP_USER_ID 必须是这个销售自己的人员 ID。

发布

cd mcp/bdt-inquiry
npm publish --access public --registry https://registry.npmjs.org/

环境变量

与 bdt-customer / bdt-website 相同：BDT_ERP_BASE_URL、SECRET、CLIENT_ID、CU_ID、USER_ID、DC。

本地开发

cd mcp/bdt-inquiry
python3.12 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest
bdt-inquiry-mcp