让 AI 助手直接会用 GradeCard

MCP（Model Context Protocol）是 AI 客户端调用外部工具的通用协议。把这一个文件放到本机，Claude Desktop / Cursor / Codex 就能在对话里直接选材、比对、算公差配合、批量挑 BOM — 不用你复制粘贴来回切网页。

第 1 步 · 拿一个 API Key

打开站点首页登录（没有账号先注册，免费）。
点右上角「我的」，找到 API Key 区块。
点「新建」，每日配额按需填（个人日常用 1000 足够），复制 gc_ 开头那串字符。

Key 只在创建时显示一次，等于你的账号凭证，不要外发或写进公开文档。

第 2 步 · 下载 MCP server

下载 gradecard_mcp.py

单文件、零依赖：只用 Python 标准库（Python 3.8+），不需要 pip install。保存在一个固定位置，例如 D:/gradecard/gradecard_mcp.py。

第 3 步 · 配置你的 AI 客户端

Claude Desktop

设置 → Developer → Edit Config，打开 claude_desktop_config.json，加一段：

{
  "mcpServers": {
    "gradecard": {
      "command": "python",
      "args": ["D:/gradecard/gradecard_mcp.py"],
      "env": { "GC_API_KEY": "gc_你的Key" }
    }
  }
}

Cursor

项目里新建 .cursor/mcp.json（或全局设置里填同样的 JSON）：

{
  "mcpServers": {
    "gradecard": {
      "command": "python",
      "args": ["D:/gradecard/gradecard_mcp.py"],
      "env": { "GC_API_KEY": "gc_你的Key" }
    }
  }
}

Codex CLI

在 config.toml 里加：

[mcp_servers.gradecard]
command = "python"
args = ["D:/gradecard/gradecard_mcp.py"]
env = { GC_API_KEY = "gc_你的Key" }

把路径换成你实际保存的位置（Windows 路径用正斜杠 / 最稳）。改完重启客户端才会加载。默认连 https://gradecard.online；要指向自建站点，在 env 里加 "GC_BASE": "https://你的站点"。

第 4 步 · 先自检，再交给 AI

不接客户端也能验证 Key 与网络是否通（命令行跑一遍）：

python gradecard_mcp.py --selftest

它会把下面 9 个工具各打一遍真实接口，逐条报 OK / FAIL：有 FAIL 就先看提示（多半是 Key 没填对或额度用完），全 OK 再去配客户端。

能干什么（9 个工具）

工具	作用
`select_material`	一句话需求 → 候选牌号 + 性能 + 估算价 + 推荐工艺（最常用）
`material_detail`	查牌号全量数据：力学、导热/导电/密度、热处理状态、标准号
`compare_materials`	2-4 个牌号逐项对比，给差异与取舍
`process_route`	材料 × 工况 → 热处理 / 表面工艺路线
`bom_select`	BOM 批量选型：多行零件一次出材料 + 工艺 + 数据来源
`tolerance_fit`	公差配合计算与场景推荐（间隙 / 过盈、配合性质）
`standard_parts`	标准件库检索（螺栓、螺母、轴承、键、销…）
`motor_select`	电机规格库与按功率 / 转速初选
`quota`	查今日额度与数据版本（不消耗额度）

配好之后直接这么问

「帮我给这张 BOM 选材：传动轴扭矩大耐磨 / 支架轻且导热好 / 外壳耐腐蚀」
「40Cr 和 42CrMo 做重载齿轮，哪个更合适？把差异列出来」
「直径 50 的轴配 H7/g6 是什么配合？最大间隙多少？」
「我要做运输液氮的容器，帮我把工况理一遍再推荐材料」

额度与数据说明

每次工具调用算一次额度（bom_select 一次最多 50 行，也只按 1 次计），按你的 API Key 计。随时用 quota 工具看剩余。返回里带的 数据版本号与引用行（标准号 + 等效牌号）可以写进你的技术文件， 结果仅供初步参考，最终选材仍需结合力学计算与试验验证。

需要更高额度或企业内网部署，见首页的客服邮箱。用 Excel / WPS 而非 AI 客户端？看 Excel 接入。