MCP 服务

可用工具

当前 MCP 支持搜索物性表、查看物性表、查询可下载资料清单、资料下载和查询价格。

当前支持

阅读时先看中文能力名,实际接入时再使用对应接口标识。技术标识不会改名, 代码示例中仍然保留真实 JSON-RPC 调用方式。

当前 MCP 服务处于 Beta 阶段,开放能力、配额和返回字段可能随版本迭代调整;工具调用需要有效年费会员权益。

搜索物性表

接口标识:tds.search

按关键词搜索公开物性表,适合先缩小候选材料范围。

返回短 ID、牌号、厂家、分类和摘要。

查看物性表

接口标识:tds.detail

根据物性表短 ID 获取详情,适合继续查看材料参数和来源信息。

返回 markdown 详情和轻量结构化元数据。

可下载资料清单

接口标识:document.list

根据物性表短 ID 查询当前可下载资料,不消耗下载次数。

返回资料类型、文件名和可直接传给下载工具的参数。

资料下载

接口标识:document.download

下载原版物性表、UL 黄卡或证书文件,成功后会计入资料下载次数。

返回文件名、标题、下载链接、过期时间和说明。

查询价格

接口标识:price.search

按关键词查询材料价格记录。

返回价格标识、标题、快照日期、价格、变化和数量。

搜索物性表

接口标识:tds.search

按材料牌号、厂家、材料类型等关键词查找公开可检索的 TDS,返回一组可继续查看的资料摘要。

查看物性表

接口标识:tds.detail

使用搜索结果里的物性表短 ID 查看详情,返回适合 AI 阅读的 markdown 内容和轻量结构化元数据。

可下载资料清单

接口标识:document.list

使用物性表短 ID 查询当前可下载资料。这个工具只返回清单和 download_arguments,不消耗下载次数。

资料下载

接口标识:document.download

把可下载资料清单里的 download_arguments 原样传入下载工具,获取原版物性表、UL 黄卡或证书文件链接。

查询价格

接口标识:price.search

按材料牌号或关键词查询价格记录,返回价格标识、标题、快照日期、价格、变化和数量。

调用参数说明

搜索物性表参数

字段 类型 说明
keyword string 必填,2 到 80 个字符,需包含文字或数字。
page integer 可选,1 到 10,默认 1。
limit integer 可选,当前单次最多 10 条,默认 10。
lang zh | en 可选,默认 zh;不支持的值会回落到 zh。

查看物性表参数

字段 类型 说明
tds_id string 必填,物性表短 ID,来自搜索物性表结果。
lang zh | en 可选,默认 zh。

资料清单参数

字段 类型 说明
tds_id string 必填,物性表短 ID,来自搜索物性表或查看物性表结果。
lang zh | en 可选,默认 zh。

资料下载参数

字段 类型 说明
document_type tds_original | ul_yellow_card | certificate_file 必填,资料类型;建议直接使用 document.list 返回的 download_arguments。
tds_id string 必填,物性表短 ID。
yc_id string 下载 UL 黄卡时必填,来自 document.list。
cert_id string 下载证书文件时必填,来自 document.list。

查询价格参数

字段 类型 说明
keyword string 必填,2 到 80 个字符,需包含文字或数字。
page integer 可选,1 到 10,默认 1。
size integer 可选,当前单次最多 10 条,默认 10。
date YYYY-MM-DD 可选,指定快照日期;非法日期会按不传日期处理。

调用示例

示例保留真实协议方法和工具名,便于开发者直接复制到 HTTP JSON-RPC 调用中。

json 确认可用能力
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}
json 搜索物性表
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "tds.search",
    "arguments": {
      "keyword": "PA66",
      "page": 1,
      "limit": 5,
      "lang": "zh"
    }
  }
}
json 查看物性表
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "tds.detail",
    "arguments": {
      "tds_id": "tds_xxx",
      "lang": "zh"
    }
  }
}
json 可下载资料清单
{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "document.list",
    "arguments": {
      "tds_id": "tds_xxx",
      "lang": "zh"
    }
  }
}
json 资料下载
{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "document.download",
    "arguments": {
      "document_type": "ul_yellow_card",
      "tds_id": "tds_xxx",
      "yc_id": "yc_xxx"
    }
  }
}
json 查询价格
{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "price.search",
    "arguments": {
      "keyword": "PA66",
      "size": 5,
      "date": "2026-07-01"
    }
  }
}

能力边界

工具只返回公开可访问资料。资料清单不消耗下载次数,实际下载会校验会员额度并记录下载历史。 当前不提供供应商联系、市场商机、价格趋势分析、询价流程、邮箱发送、批量下载或私有字段。