MCP Server 使用指南

让 Claude、Cursor、Windsurf 等 AI 编程助手直接调用 RoboParts 选型引擎,在对话中完成机器人零部件的智能选型与兼容性分析。

Model Context Protocol

📚 什么是 MCP Server

MCP (Model Context Protocol) 是 Anthropic 推出的开放协议,用于让 AI 模型与外部工具/数据源进行标准化交互。RoboParts MCP Server 将平台的选型引擎、零部件数据库、兼容性分析等能力封装为 MCP 工具,使 AI 编程助手能够在对话中直接调用这些能力。

接入后,您只需用自然语言描述需求(如"推荐人形机器人的执行器"),AI 助手便会自动调用 search_components 工具,返回匹配的零部件列表。无需手动构造 HTTP 请求,开发效率大幅提升。

当前 RoboParts MCP Server 提供 5 个工具,覆盖零部件搜索、详情查询、兼容性检查、场景推荐和参数口径规范等核心场景。

🔧 工具列表

以下 5 个 MCP 工具可供 AI 编程助手调用,每个工具包含名称、功能描述和参数说明。

search_components
搜索机器人零部件。可按品类、关键词筛选,返回匹配条目的摘要(id/名称/品类/厂商/关键规格/证据等级)。覆盖执行器、传感器、芯片、通信协议、接口、机器人平台、具身智能模型等 10 个品类。
categorystring - 品类精确筛选,须来自枚举
keywordstring - 关键词,对多字段做子串匹配(中英文命中集可能不重叠,建议两种都试)
limitnumber - 返回条数上限,默认 10,最大 50
include_market_intelligenceboolean - 是否含市场情报条目,默认 false
get_component_detail
按 ID 获取单个零部件的完整字段,含 source_tier(数据来源等级)、confidence(置信度)、data_quality 与 mechanical_interface 等元数据,用于在采购/设计决策前核对证据强度。
idstring - 零部件 ID(如 ACT-001),大小写与连字符需完全匹配(必填)
check_compatibility
判定两个零部件在 protocol(协议)/ electrical(电气)/ mechanical(机械)/ software(ROS2)四个维度的兼容性,返回逐维结论、总体判定与置信说明。结论基于厂商公开声明字段做规则推断,非实验室实测。
component1_idstring - 零件 1 ID(必填)
component2_idstring - 零件 2 ID,可与零件 1 不同品类(必填)
recommend_for_application
按应用场景推荐零部件组合,可选预算上限(USD)。返回各品类的候选项及推荐理由。基于库内字段的启发式筛选,不构成工程选型意见,最终仍需核对厂商原始数据手册。
applicationstring - 应用场景(必填:humanoid/quadruped/robot_arm/amr/industrial)
budgetnumber - 单件预算上限 USD,可选(仅剔除确定超预算项)
countnumber - 每品类返回条数,默认 3,上限 10
get_parameter_semantics
获取参数口径规范:同一 torque/speed 字段在不同厂商含义可能不同(库内 torque 出现 19 种口径、speed 37 种,甚至混入 Gbps 与 rad/s)。返回物理红线、单位换算、可比性分级与向厂商问询的清单,用于判断两份参数表到底能不能直接比较。
(无入参)本工具不接受参数,调用即返回参数口径规范

配置指南

将 RoboParts MCP Server 添加到您的 AI 编程工具中。推荐使用下方「远程接入」——无需下载代码、无需 API Key,复制即用。

推荐 · 远程接入(零安装,无需 API Key)
{
  "mcpServers": {
    "roboparts": {
      "url": "https://roboparts.cc/mcp"
    }
  }
}

适用于已原生支持 streamable-HTTP 的客户端(Cursor、Windsurf、VS Code 等)。 基础检索与兼容性校验无需 API Key 即可直接调用

Claude Desktop(经 mcp-remote 桥接)
{
  "mcpServers": {
    "roboparts": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://roboparts.cc/mcp"]
    }
  }
}

Claude Desktop 尚未原生支持远程 MCP,需经开源桥接包 mcp-remote 转接(npx 自动拉取,无需预装)。

本地部署(进阶,可离线运行)

如需离线或自行改造,可克隆仓库后指向本地入口文件。 先执行: git clone https://github.com/lm203688/roboparts.git ,随后把下方配置中的 /path/to/roboparts 替换为你的实际克隆路径。

claude_desktop_config.json
{
  "mcpServers": {
    "roboparts": {
      "command": "node",
      "args": ["/path/to/roboparts/mcp-server/index.js"],
      "env": {
        "ROBOPARTS_API_KEY": "gtk_your_api_key_here"
      }
    }
  }
}

配置文件路径:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
.cursor/mcp.json
{
  "mcpServers": {
    "roboparts": {
      "command": "node",
      "args": ["/path/to/roboparts/mcp-server/index.js"],
      "env": {
        "ROBOPARTS_API_KEY": "gtk_your_api_key_here"
      }
    }
  }
}

在项目根目录下创建 .cursor/mcp.json 文件,Cursor 会自动加载 MCP Server。

.windsurf/mcp.json
{
  "mcpServers": {
    "roboparts": {
      "command": "node",
      "args": ["/path/to/roboparts/mcp-server/index.js"],
      "env": {
        "ROBOPARTS_API_KEY": "gtk_your_api_key_here"
      }
    }
  }
}

在项目根目录下创建 .windsurf/mcp.json 文件,Windsurf 会自动识别并加载。

快速体验

输入自然语言查询,直接调用选型引擎 API 查看效果。需要有效的 API Key。

在线测试选型引擎

API Key *
应用场景
需求描述(自然语言)
本次调用将消耗 2 积分

🐍 Python SDK 示例

如果您更习惯使用 Python,可以通过 HTTP 直接调用选型引擎 API。以下是一个完整的示例。

selection_example.py
# RoboParts 智能选型引擎 - Python SDK 示例

import requests

API_BASE = "https://roboparts.cc"
API_KEY = "gtk_your_api_key_here"  # 替换为您的 API Key

# 1. 智能选型推荐
response = requests.post(
    f"{API_BASE}/api/selection/engine",
    headers={"Content-Type": "application/json"},
    json={
        "api_key": API_KEY,
        "application": "humanoid",
        "requirements": {
            "torque_min": 10,
            "weight_max": 500,
            "voltage": 48,
            "ros_required": True,
        },
        "categories": ["actuators", "sensors"],
        "count_per_category": 3,
    }
)
result = response.json()

if result.get("success"):
    for category, items in result.get("recommendations", {}).items():
        print(f"\n=== {category} ===")
        for item in items:
            print(f"  {item['name']} ({item['component_id']})")
            print(f"    评分: {item.get('score', 'N/A')} | 价格: {item.get('price', 'N/A')}")
else:
    print(f"Error: {result.get('error', 'Unknown')}")

# 2. 查询余额
balance_resp = requests.get(
    f"{API_BASE}/api/credits/balance?key={API_KEY}"
)
print(f"\n当前积分: {balance_resp.json().get('credits', 0)}")

🧩 Skills 技能包(其它 Agent 框架一键接入)

除直接连 MCP 外,RoboParts 把能力封装成结构化 Skills 清单,可被 WorkBuddy / Dify / Coze / Cursor 等框架解析后自动注册工具。机器可读清单:/skills/manifest.json · 说明文档:/skills/README.md

roboparts-search
搜索归一化零部件库(708 实体 / 325 开源组件),按品类、关键词、规格筛选。
触发找某类零件 / 补全型号
roboparts-component-detail
按 ID(如 ACT-001)取单件完整规格、厂商、证据等级与数据缺口。
触发已有 ID 要详情
roboparts-compat-check
四维兼容性裁决,未声明维度如实标「无法判定」(零假绿/零假红)。
触发判断两件零件能否装一起
roboparts-recommend
按应用场景(humanoid/quadruped/robot_arm/amr/industrial)与预算推荐零件组合。
触发按场景/预算配一套零件
roboparts-parameter-semantics
参数口径规范、单位换算、可比性分级与物理自洽红线。
触发参数靠不靠谱 / 怎么比
roboparts-dataset-discovery
发现并下载公开数据集端点(entities/oss/mechanical_interfaces 等)。非 MCP 工具,直接 GET 静态 JSON。
触发下载 / 引用原始数据
roboparts-adapter-generate
法兰不兼容时生成可 3D 打印转接板(web_resource,拼 URL 参数复现)。
触发机械法兰不匹配需转接

🤖 物理 AI 训练数据集

RoboParts 把兼容性数据层整理成一份可直接被具身智能 / Sim-to-Real 训练流水线消费的结构化数据集,让 MoziSim、Isaac 这类训练平台无需手工解析网页即可直接拉取。

数据集含三部分:零件目录(规格 + 标准标签 + 证据等级)、兼容性关系(按 protocol / electrical / mechanical / software 四维裁决、仅保留有证据的关系)、互操作性标准登记表

免鉴权、随主库实时更新;也可通过 MCP 资源 resources/list 自动发现(资源 URI 即下方地址)。

数据集端点
GET https://roboparts.cc/api/training_dataset.json

兼容性关系由规则引擎现算(非实验室实测),数据集 meta 字段如实标注生成时间与口径。接入训练流水线前,请结合厂商原始数据手册核验关键参数。