用途
quality-control-plan-mcp 是一个 Model Context Protocol（MCP）服务器，将 Imnoo 的图纸分析引擎（即 quality-check-protocol.imnoo.com 背后的引擎）暴露给任何支持 MCP 的助手。用户只需将技术图纸 PDF 交给助手，即可在约一分钟内获得带编号的检验计划：自动提取每个尺寸公差、ISO 配合、螺纹、几何公差（GD&T）和表面粗糙度，在图纸上添加气泡编号，并列出验收限值与建议量具。
主要能力
- 自动提取：从技术图纸 PDF 中识别尺寸公差、ISO 配合、螺纹（含细牙螺纹）、几何公差（GD&T）和表面粗糙度。
- 验收限值：对带数值公称尺寸的普通尺寸公差计算验收限值（公称尺寸 + 下/上偏差，四舍五入到两位小数），例如 ⌀50 ±0.05 变为 49.95–50.05。配合、螺纹、几何公差和表面粗糙度按量具检验而非限值测量，与 Imnoo 计算器规则一致。
- 气泡编号：支持保留图纸上印刷的编号或重新编号（1、001 或 D001 风格，按阅读或测量顺序）。编号由选择和编号设置派生，删除特征后其余自动重新编号。
- 检验等级：可指定检验等级（100% 全检、Q1 抽检、Q2 抽检）。
- 导出：生成带气泡的图纸 PDF、完整检验包以及 Excel 测量与检验报告。
- 测量判定：输入的实测样本值会根据限值判定合格/不合格，结果和日期会出现在两份文档中。
- 默认分段顺序：按测量工作流排列——几何公差（CMM）在前，表面粗糙度（粗糙度仪）在后。
- 提示词：提供 create-quality-plan 提示词，引导助手完成“分析 → 审查 → 导出”流程。
使用方式
环境要求
需要 Node.js ≥ 18。
安装与配置
将服务器添加到 MCP 客户端配置中。以下为官方提供的配置示例（保留原文）：
Claude Desktop（Settings → Developer → Edit Config，添加到 claude_desktop_config.json）：
{
"mcpServers": {
"quality-control-plan": {
"command": "npx",
"args": ["-y", "quality-control-plan-mcp"]
}
}
}
Cursor（添加到 ~/.cursor/mcp.json）：
{
"mcpServers": {
"quality-control-plan": {
"command": "npx",
"args": ["-y", "quality-control-plan-mcp"]
}
}
}
VS Code (GitHub Copilot)、Windsurf / 其他 stdio 客户端：任何启动 stdio 服务器的客户端均可使用相同命令。
示例会话
用户：为 C:\drawings\flange.pdf 构建 Q1 质量计划，使用类型前缀编号，并将所有内容写到图纸旁边。
助手：调用 analyze_drawing —— 2 页共 17 个特征：5 个尺寸公差、2 个钻孔配合（⌀10 H7 保留印刷气泡 1）、1 个轴配合、2 个螺纹、1 个细牙螺纹、2 个几何公差、4 个表面粗糙度；图纸 QP-1001-A，零件 4711-050，AlMg3，ISO 2768-mK。调用 build_quality_plan，inspection_class: "Q1"，numbering: { style: "typePrefixed" } —— D001 ⌀50 (±0.05) → 49.95–50.05（卡尺），H001 ⌀10 H7（内径千分尺），G001 ⏥ 0.05（CMM），R001 Ra 3.2（表面粗糙度仪）……调用 export_inspection_pdf 和 export_quality_plan_excel 使用同一计划 —— 写出 QP-1001-A_inspection-package.pdf（两页图纸均带气泡 + 印刷计划）和 QP-1001-A_Q1.xlsx。第 2 页有两个值读取置信度低——在计划下发车间前值得检查。
计划选项（plan 参数）
一个对象，由 build_quality_plan 和两个导出工具接受——在所有地方传递同一个对象，以确保文档与审查后的计划一致。所有字段均可选；默认值复现 Web 应用的初始计划。
适用场景
- 首件检验（FAI）
- PPAP 式尺寸报告
- 车间质量检查协议
- 矢量与扫描 PDF 均可处理
限制
- 分析上传：analyze_drawing 是唯一离开本机的工具，会将 PDF 上传至 Imnoo 的图纸分析（与 Web 应用相同）。免费层每 IP 每日 1 次分析；PDF 最大 30 MB。上传文件在短暂保留期后自动删除，不用于其他用途。已保存的分析（save_analysis_to → load_analysis）无限制且离线。
- 本地运行：计划构建、编号、验收限值、Excel 和 PDF 生成均在本地离线运行。无遥测，无其他网络调用。
- 分析准确性：图纸分析是自动化的，可能遗漏或误读特征，尤其在低质量扫描件上——需对照图纸验证计划（rows[].value 可修正值，exclude 可删除行）。
- Web 应用专属功能：手绘特征、拖动气泡以及将计划保存到 Imnoo 计算器仅为 Web 应用功能。
- 加密或异常 PDF：无法复制的加密或异常 PDF 在此处回退到 variant: "plan"（Web 应用则将其栅格化）。
- 构建来源：此包从 Imnoo 的 Quality Check Protocol monorepo 构建，直接导入 Web 应用的领域层（图纸映射器、计划数学、编号引擎、Excel 和 PDF 构建器），因此 Web 应用和此服务器按构造产生相同的计划和文档。每个版本都通过 61 项端到端检查，这些检查通过 stdio 驱动所有五个工具针对捆绑的示例图纸运行。
数据与隐私
唯一离开本机的数据是传递给 analyze_drawing 的图纸 PDF：它通过 HTTPS 上传至 quality-check-protocol.imnoo.com 的 Imnoo 图纸分析以检测特征，在 24 小时内自动删除，不用于其他任何用途。无遥测，无其他网络调用；计划构建和 Excel/PDF 导出在本地机器上运行。Imnoo 隐私政策：https://www.imnoo.com/en/privacy-policy · 版本说明：https://www.imnoo.com/en/imprint · 问题反馈：https://github.com/imnoo-team/quality-control-plan-mcp/issues
