CutOptim Engine

CutOptim MCP 服务

将切割优化作为 AI 助手的工具：二维板材、一维棒材、木材和真实形状排样，
通过 CutOptim Engine API 和 Model Context Protocol 实现。

MCP 指南 · API 参考 · 获取免费测试密钥

---

两种连接方式

托管方式（无需安装） — 将 MCP 客户端指向 https://api.cutoptim.com/mcp，并添加请求头 Authorization: Bearer <your API key>。Claude Code、Cursor、VS Code 和 Claude Desktop 的配置请参阅 MCP 指南。

本地方式（此软件包，stdio） — 在你的计算机上运行，并使用你的密钥调用同一 API：

{
  "mcpServers": {
    "cutoptim": {
      "command": "npx",
      "args": ["-y", "@cutoptim/mcp"],
      "env": { "CUTOPTIM_API_KEY": "co_test_YOUR_KEY" }
    }
  }
}

Claude Code：claude mcp add cutoptim --env CUTOPTIM_API_KEY=co_test_YOUR_KEY -- npx -y @cutoptim/mcp

变量	含义
CUTOPTIM_API_KEY	你的密钥：co_live_…、co_test_…（永不计费）或公开演示密钥。未提供密钥时，只能使用 validate_* 工具。
CUTOPTIM_BASE_URL	默认值为 https://api.cutoptim.com

需要 Node 18 或更高版本。

工具

工具	功能	费用
optimize_2d	根据板材优化矩形零件：布局、切割方案、出材率	一次 API 调用
optimize_1d	根据棒材、管材、型材优化长度	一次 API 调用
optimize_wood	根据横截面优化木材零件	一次 API 调用
optimize_nest	在板材上排放自由形状的多边形零件	一次 API 调用
validate_2d · validate_1d · validate_wood · validate_nest	检查请求，但不执行求解	免费
get_job	读取异步 engine: "max" 任务	免费
get_usage	本月已使用和剩余的调用次数	免费

每个工具的参数都与其端点的请求正文完全一致——其架构由 OpenAPI 文档生成。每个结果都包含供助手使用的简短摘要，以及作为 structuredContent 的 API JSON 响应。

配额和计费

每次工具调用对应一次 Engine API 调用：使用相同的密钥、配额、速率限制和计费方式，与自行调用 REST API 相同。 客户端会在每次优化调用中发送 Idempotency-Key，因此自身重试不会被重复计费。

许可证和支持

MIT。本仓库从 CutOptim 单体仓库发布；请在 Issues 中报告 Bug，或发送邮件至 [email protected]。