ARCNM

ARCNM MCP 服务

为你的 Agent 根据 CAD 文件和图纸计算制造目标成本。 将 ARCNM 连接到 Claude、GitHub Copilot、Cursor 或任何 MCP 客户端，即可根据 STEP 文件或 PDF 图纸为零件估价、说明成本构成因素、读取工艺计划、比较设计方案、批量大小和成本核算环境，以及进行钣金订单排样。每项数据都能追溯到其背后的物理原理。

此仓库介绍该服务。ARCNM 托管此服务，因此无需安装或运行任何内容。

端点	https://api.arcnm.io/mcp-server/mcp（Streamable HTTP）
注册表	MCP 注册表中的 io.arcnm/arcnm
登录	使用 ARCNM 账户进行 OAuth 登录，或使用 ARCNM API 密钥作为 bearer token
文档	arcnm.io/docs/mcp

所需条件

一个 ARCNM 账户。免费套餐每月包含 10 次计算，无需绑定银行卡。读取结果不收费；启动计算会消耗配额，check_quota 可告知你的 Agent 剩余配额。

连接

VS Code 中的 GitHub Copilot

将服务添加到 .vscode/mcp.json：

{
  "servers": {
    "arcnm": {
      "type": "http",
      "url": "https://api.arcnm.io/mcp-server/mcp"
    }
  }
}

在 MCP 视图中启动服务，并按提示在浏览器中登录 ARCNM。如要改用 API 密钥，请将其作为标头发送：

{
  "inputs": [
    { "type": "promptString", "id": "arcnm-key", "description": "ARCNM API key", "password": true }
  ],
  "servers": {
    "arcnm": {
      "type": "http",
      "url": "https://api.arcnm.io/mcp-server/mcp",
      "headers": { "Authorization": "Bearer ${input:arcnm-key}" }
    }
  }
}

Claude 和 Claude Desktop

ARCNM 已收录在 Claude 连接器目录中。在那里添加它，并使用你的 ARCNM 账户登录。

Claude Code

claude mcp add --transport http arcnm https://api.arcnm.io/mcp-server/mcp

然后在 Claude Code 中运行 /mcp 进行登录。使用 API 密钥时：

claude mcp add --transport http arcnm https://api.arcnm.io/mcp-server/mcp \
  --header "Authorization: Bearer $ARCNM_API_KEY"

Cursor

在 ~/.cursor/mcp.json 中（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "arcnm": {
      "url": "https://api.arcnm.io/mcp-server/mcp"
    }
  }
}

Cursor 会打开 ARCNM 登录页面。如要使用 API 密钥，请添加 "headers": { "Authorization": "Bearer ${env:ARCNM_API_KEY}" }。

其他 MCP 客户端

将 Streamable HTTP 传输指向 https://api.arcnm.io/mcp-server/mcp。支持 MCP 授权的客户端会根据服务的受保护资源元数据自动找到登录入口。否则，请发送 Authorization: Bearer <your ARCNM API key>。

登录与权限

OAuth。 使用 ARCNM 账户登录，并选择客户端可以使用的组织。授权页面会列出客户端请求的所有权限，你可以取消勾选任意权限。客户端只能查看该组织的数据。

API 密钥。 在 ARCNM 的 Settings → API keys 下创建密钥，并仅授予 Agent 所需的权限范围：

权限范围	允许 Agent 执行的操作
parts:read	读取计算结果、成本、工艺计划和成本核算环境
parts:write	为零件估价（upload_and_quote、quote_part）并取消计算
uploads:write	直接上传文件，使用 uploads 工具集

Agent 只会看到其凭据允许使用的工具。

工具

无需额外配置时，服务会列出这 15 个工具。每个工具都带有 readOnlyHint 和 destructiveHint，因此客户端可以知道哪些调用只会读取、哪些会更改内容，并可先征求你的确认。

为零件报价

工具	功能
upload_and_quote	一次调用即可根据 CAD 文件为新零件报价：STEP 文件，或带有板厚和材料信息的 DXF 平面图，还可选配 PDF 图纸。仅在计算成功时消耗配额。	write
get_upload_link	提供 ARCNM 上传页面的链接，用于上传电脑上的文件。	read
quote_part	重新为 ARCNM 中已有的零件报价：更改批量、材料或成本核算环境，或一次使用多个环境。仅在计算成功时消耗配额。	write

跟踪或停止计算

工具	功能
get_calculation	查看单次计算的状态、运行时剩余时间，以及完成报价后的结果。	read
list_calculations	按零件、批次、状态或开始时间查找计算。	read
cancel_calculation	停止排队中或正在运行的计算。取消的计算不会计费。	write

查看结果

工具	功能
explain_cost	查看总成本和工时、预测区间、成本明细及主要成本驱动因素。	read
get_cost_breakdown	查看任意批量的逐项成本清单。	read
get_process_plan	查看工艺路线、工作中心和周期时间。	read

改进与比较

工具	功能
preview_cost	调整影响因素或更改批量，重新计算报价。不会消耗配额，也不会写入任何内容。	read
optimize_lot_size	查找总成本最低的批量，并查看成本与数量的关系曲线。	read
suggest_cost_savings	列出所有降本方向，以及各自的杠杆因素和置信度。	read
compare_calculations	比较两次计算的价格差异；比较三到二十次计算时，则给出排名。	read

查询

工具	功能
list_environments	列出组织的成本核算环境。	read
check_quota	查看组织剩余的计算配额。	read

这 15 个工具都不会删除任何内容。其他工具——直接上传、零件、排名后的成本驱动因素、成本核算环境和假设调整、钣金套料、材料与工装目录、校准、文件夹——会在客户端发送包含所需工具集或 all 的 X-MCP-Toolsets 标头时列出；请参阅工具集。

提示词

服务还附带 5 个提示词，引导 Agent 完成整个工作： cost_a_part、compare_calculations、compare_environments、explain_cost 和 find_cost_drivers。

试试看

• “为这个 STEP 文件按批量 1、10 和 100 报价，并告诉我成本花在哪里。”
• “这个零件的三大成本驱动因素是什么？改变它们会有什么影响？”
• “比较这个支架在我们各成本核算环境中的报价，并告诉我在哪里制造更合适。”
• “哪个批量的总成本最低？”

支持

如有疑问或遇到问题，请联系 [email protected]，或在此处提交 issue。文档：arcnm.io/docs/mcp。 可运行的 API 示例：arcnm/arcnm-examples。

ARCNM 由德国于伯林根的 rattle mng GmbH 开发。