{
  "name": "roboparts",
  "version": "1.1.0",
  "transport": "streamable-http",
  "endpoint": "https://roboparts.cc/mcp",
  "protocol_versions": [
    "2025-06-18",
    "2025-03-26",
    "2024-11-05"
  ],
  "authentication": "none — 只读、免鉴权、不设 cookie、不存储调用方数据",
  "tools": [
    {
      "name": "search_components",
      "description": "搜索机器人零部件。可按品类、关键词筛选，返回匹配条目的摘要（id/name/category/manufacturer/关键规格/证据等级）。覆盖执行器、传感器、芯片、通信协议、接口、机器人平台、具身智能模型等 20 个品类。库存实时口径（总数/可选型/已隔离）见 initialize 的 instructions 或 GET /mcp 的 dataset 字段 —— 此处不写死数字，避免文案与真实库存漂移。"
    },
    {
      "name": "get_component_detail",
      "description": "按 ID 获取单个零部件的完整字段，包含 source_tier（数据来源等级）、confidence（置信度）、data_quality 与 mechanical_interface 等元数据。用于在做出采购/设计决策前核对证据强度。"
    },
    {
      "name": "check_compatibility",
      "description": "判定两个零部件在 protocol（协议）/ electrical（电气）/ mechanical（机械）/ software（ROS2）四个维度的兼容性，返回逐维结论、总体判定与置信说明。注意：结论基于厂商公开声明字段做规则推断，非实验室实测；厂商未声明的维度记为\"无法判定\"，既不计入兼容也不计入不兼容。"
    },
    {
      "name": "compare_components",
      "description": "并排对比 2~6 个零部件的关键参数（torque/speed/voltage/protocol/interface/weight/price），相同值自动标注，替代为同一目的连发多次 get_component_detail。缺失字段以 null 呈现，不代表不支持该特性；跨厂商数值比较请配合 get_parameter_semantics。"
    },
    {
      "name": "recommend_for_application",
      "description": "按应用场景推荐零部件组合，可选预算上限（USD）。返回各品类的候选项及推荐理由。这是基于库内字段的启发式筛选，不构成工程选型意见，最终仍需核对厂商原始数据手册。"
    },
    {
      "name": "get_parameter_semantics",
      "description": "获取参数口径规范：同一个 torque/speed 字段在不同厂商那里含义可能不同（库内 torque 出现 19 种口径、speed 37 种，甚至混入 Gbps 与 rad/s）。本工具返回物理红线、单位换算、可比性分级与向厂商问询的清单，用于判断两份参数表到底能不能直接比较。"
    },
    {
      "name": "bom_compatibility_check",
      "description": "对一组零部件（BOM，物料清单）做两两兼容性矩阵。输入已有条目 ID（可含开源贡献层 OSS-xxx），返回每个组合在 protocol/electrical/mechanical/software 四维的判定与理由。判定基于厂商公开声明字段的规则推断而非实测；未声明维度记为无法判定，不会为了填满矩阵而编造结论。返回的 verdict_reason 才是结论依据，overall_compatible=null 表示\"证据不足\"，不等于不兼容。"
    },
    {
      "name": "semantic_search",
      "description": "用自然语言描述需求（如\"人形机器人髋部高扭矩电机\"）做语义召回，返回最相近的零部件。语义索引由离线哈希 TF-IDF 向量（构建时预计算、零外发、零外部模型）在当前全量实体上生成，是兼容性判定之外的\"发现\"通道：当你不确定零件的确切型号或参数名时，用它比关键词子串匹配更稳。索引不可用时自动降级为关键词检索，并明确告知。"
    },
    {
      "name": "get_standard_audit",
      "description": "返回标准登记表 ↔ 实体声明 的自动交叉校验结果：哪些机械/总线声明能被已知标准集核实、哪些声明的编码不在已知指定集中（无法核实），以及登记表缺口与行业标准覆盖情况。这是数据质量自检，不是兼容性裁决；其作用是指出\"声明了但出处存疑\"的条目，供人工补全证据。"
    },
    {
      "name": "review_compatibility",
      "description": "对两个零部件做「多 Agent 质保复核」：Worker 层执行标准四维兼容性裁决（与 /api/compatibility 同一引擎），Governor 层独立复核结论——按证据强度给出 L0–L3 风险分级、在证据不足 2 条时把\"兼容\"降级为\"需人工确认\"、对无法判定项显式列出缺失证据段。返回四维细节 + 证据契约 + governor_review。只读、免鉴权。"
    }
  ],
  "resources": [
    {
      "uri": "https://roboparts.cc/api/training_dataset.json",
      "name": "RoboParts 物理 AI 训练数据集",
      "description": "面向物理 AI / 具身智能 / TurboVLA 类 V+L→A 策略的多模态结构化数据集（schema v2.0）：零件目录（含标准标签、证据等级、多模态暴露 force/tactile/geometric/electrical/vision）+ 兼容性关系（四维裁决现算，并标注 interaction_type 与 force_profile 力觉剖面）+ 互操作性标准登记表。force/tactile 仅声明级参数，原始传感时序为零。免鉴权，HTTP GET 即可拉取全文。",
      "mimeType": "application/json"
    }
  ],
  "dataset": {
    "total_entities": 798,
    "flywheel_contributions": 142,
    "selectable": 589,
    "market_intelligence": 17,
    "organizations": 10,
    "specifications": 101,
    "software": 81,
    "quarantined": 99,
    "usable": 535,
    "priced": 209,
    "id_category_mismatch": 15,
    "categories": [
      "actuators",
      "sensors",
      "chips",
      "interfaces",
      "protocols",
      "llms",
      "platforms",
      "flexible_actuators",
      "robot_ai_models",
      "data_acquisition",
      "connectors",
      "integrated_joints",
      "reducers",
      "controllers",
      "grippers",
      "structural",
      "cables",
      "power",
      "pcb",
      "bionic_mechanisms"
    ]
  },
  "instructions": "RoboParts 是仿生/人形机器人零部件的兼容性数据层（执行器、传感器、芯片、通信协议、接口、平台、具身智能模型等 20 个品类）。\n\n适合用它来做：确认两个零件能否搭配、按场景筛选候选件、核对某个参数的口径是否可比。\n\n必须如实转述给最终用户的边界：\n1. 我们既不生产也不转售任何零部件，与任何厂商无商业绑定，数据层保持中立。\n2. 兼容性结论来自厂商公开声明字段的规则推断，不是实验室实测。厂商未声明的维度一律标为\"无法判定\"，我们不会拿它凑分数。\n3. 参数口径在行业内并不统一（库内 torque 字段出现 19 种口径、speed 37 种），跨厂商直接比数字往往是错的 —— 需要时请调用 get_parameter_semantics。\n4. 标记 quarantine=true 的条目存在已知疑点，不应作为决策依据。\n\n本端点只读、免鉴权、不写入任何用户数据、不设 cookie。若需要写入类能力（BOM 保存、选型报告导出），见 https://roboparts.cc/mcp-guide\n\n数据集实况（本次响应实时统计，非写死文案）：共 798 条实体，其中 589 条为可选型零部件、101 条为接口/协议规范（EtherCAT、USB 3.0…）、81 条为 AI 模型与软件（GPT-4o、RT-2…）、17 条为市场情报（专利地图/咨询报告）、10 条为企业/机构主体条目（如 Figure AI、波士顿动力）。后四类都没有物理接口，不进检索推荐、也不作为兼容性判定操作数。另有 99 条（占 12.4%）标记 quarantine=true —— 存在已知疑点（占位 ID / 无法核实的厂商 / 重复 / 根本不是零件的行业词），本端点的检索与推荐已默认排除它们，实际可选型 535 条。若你从 REST 接口（/api/*.json）自行取数，这些条目会照原样返回，请自行按 quarantine 字段过滤。带价格字段的仅 209 条。",
  "quickstart": {
    "claude_desktop": "在 MCP 设置里添加一个 Streamable HTTP 服务器，URL 填 https://roboparts.cc/mcp，无需 API Key。",
    "curl": "curl -s -X POST https://roboparts.cc/mcp -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'"
  },
  "docs": "https://roboparts.cc/mcp-guide"
}