CutOptim Engine

CutOptim MCP サーバー

AI アシスタント向けの切断最適化ツール：2D パネル、1D バー、木材、真の形状のネスティングを、
CutOptim Engine APIとModel Context Protocolを通じて利用できます。

MCP ガイド · API リファレンス · 無料のテストキーを取得

---

接続方法は2通り

ホスト型（インストール不要） — 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 呼び出し1回
optimize_1d	バー、チューブ、プロファイルから長さを最適化	API 呼び出し1回
optimize_wood	断面に基づいて木材部品を最適化	API 呼び出し1回
optimize_nest	シート上の自由形状のポリゴン部品を配置	API 呼び出し1回
validate_2d · validate_1d · validate_wood · validate_nest	実行せずにリクエストを検証	無料
get_job	非同期の engine: "max" ジョブを読み取る	無料
get_usage	今月の使用済み回数と残り回数を確認	無料

各ツールの引数は、対応するエンドポイントのリクエスト本文とまったく同じです。スキーマは OpenAPI ドキュメントから生成されています。すべての結果には、アシスタント向けの短い概要と、structuredContent として API の JSON 回答が含まれます。

クォータと課金

ツール呼び出し1回につき、Engine API の呼び出し1回分となります。REST API を直接呼び出す場合と同じキー、クォータ、レート制限、課金が適用されます。 クライアントは最適化呼び出しごとに Idempotency-Key を送信するため、クライアントによる再試行で二重に課金されることはありません。

ライセンスとサポート

MIT。このリポジトリはCutOptimモノレポから公開されています。バグの報告は Issuesに投稿するか、[email protected] までご連絡ください。