MCP 服务

工具总览

当前 MCP 支持公开 TDS、资料文件、价格查询、采购、供应和买卖联系,共 19 个工具。

当前支持

权限和配额

账号需具备 MCP 业务权限。免费账号和 VIP 会员账号按下表区分额度,资料下载属于会员能力。

工具 免费账号 VIP 会员账号
搜索物性表 tds.search 每日共享 20 次查询;仅第一页,最多 10 条 每日查询次数不限;仅第一页,最多 10 条
查看物性表 tds.detail 每日共享 20 次查询 不限
资料清单 document.list 可用,不消耗下载次数 可用,不消耗下载次数
资料下载 document.download 仅 VIP 会员可用 可用,按资料下载额度计数
查询价格 price.search 每日共享 20 次查询 不限
购买材料 material.purchase.create 每日 5 条 不限
上传尾料 material.supply.create 可用,不消耗每日业务额度 可用,不消耗每日业务额度
查询尾料 material.supply.search 可用,不消耗每日业务额度 可用,不消耗每日业务额度

仅 tds.search、tds.detail、price.search 共享每日查询额度,多个 Key 按同一用户合并计数;仅 material.purchase.create 消耗购买材料额度。 供应工具、采购管理和联系工具不消耗这两类额度,仍受请求限流和访问权限约束。 document.list 不消耗查询或下载次数,document.download 按平台资料下载额度规则计数。

管理与联系工具

以下工具供已具备 MCP 业务权限的免费和 VIP 账号使用,不消耗每日查询或购买材料额度。完整参数可通过 tools/list 获取。

  • material.purchase.list:查看自己的采购需求。
  • material.purchase.detail:用 purchase_id 查看自己的采购详情。
  • material.purchase.update:更新自己的有效采购需求,传入 purchase_id 和上次读取的 updated_at(字段名 expected_updated_at),修改后立即发布。
  • material.purchase.cancel:用 purchase_id 取消自己的采购需求。
  • material.supply.list:查看自己发布的供应。
  • material.supply.detail:用 supply_id 查看自己的供应详情。
  • material.supply.update:更新自己的有效供应,传入 supply_id 和 expected_updated_at,修改后立即发布。
  • material.supply.withdraw:用 supply_id 撤回自己的供应。
  • material.contact.request:针对选定的 supply_id 申请联系,提供 amount(正整数 kg)、price_attitude 和收货地 addr;指定 target_price 时还需提供目标价格。
  • material.contact.list:查看自己发出或收到的申请,可用 request_id 查询一条;批准后按权限返回对方的业务联系方式。
  • material.contact.respond:卖方明确决定后,用 request_id 和 decision(approve 或 reject)处理待审批的联系申请。

列表工具的 page 范围为 1–10,limit 为 1–10;管理工具只允许操作本账号的记录。联系申请获批准前不会公开对方联系方式。

使用建议

先确认工具

接入后先调用 tools/list,确认客户端已读取当前账号可用能力。

查资料

先用 tds.search 找到候选材料,再用 tds.detail 查看详情或 document.list 查询资料清单。

下载文件

需要文件时先调用 document.list,再把 download_arguments 传给 document.download。

购买材料

需要平台线下联系确认现货、价格和交付时,查看购买材料工具页中的材料、数量、交付地和补充要求示例。

处理尾料

供应方可发布供应,买方可查询公开库存;查询结果不返回联系方式。选定供应后可发起联系申请,卖方批准后再查看对方业务联系方式。