ARCNM

ARCNM MCP サーバー

エージェント向けに、CAD データや図面から製造コストを見積もります。 ARCNM を Claude、GitHub Copilot、Cursor、または任意の MCP クライアントに接続すると、STEP ファイルや PDF 図面から部品の価格を算出し、コストの要因を説明し、工程計画を読み取り、設計、ロットサイズ、原価計算環境を比較し、板金注文のネスティングを行えます。すべての数値は、その算出根拠となった物理現象までさかのぼって確認できます。

このリポジトリではサーバーについて説明しています。サーバーは ARCNM がホストしているため、インストールや実行は不要です。

エンドポイント	https://api.arcnm.io/mcp-server/mcp（Streamable HTTP）
レジストリ	MCP Registry の io.arcnm/arcnm
サインイン	ARCNM アカウントでの OAuth、またはベアラートークンとしての ARCNM API キー
ドキュメント	arcnm.io/docs/mcp

必要なもの

ARCNM アカウントが必要です。Free プランには月 10 回の計算が含まれており、クレジットカードは不要です。結果の閲覧は無料です。計算を開始すると利用枠が消費され、check_quota でエージェントに残りの利用枠を知らせられます。

接続

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 で API キーを作成し、エージェントに必要なスコープのみを付与してください。

スコープ	エージェントに許可される操作
parts:read	計算結果、コスト、工程計画、原価計算環境の読み取り
parts:write	部品の価格算出（upload_and_quote、quote_part）と計算のキャンセル
uploads:write	uploads ツールセットを使ったファイルの直接アップロード

エージェントに表示されるのは、認証情報で使用が許可されているツールのみです。

ツール

追加設定なしで、サーバーは以下の15個のツールを一覧表示します。それぞれに readOnlyHint と destructiveHint が設定されているため、クライアントは どの呼び出しが読み取りのみで、どれが変更を加えるのかを把握し、事前に確認を求めることができます。

部品の価格を見積もる

ツール	機能
upload_and_quote	CAD ファイルから新しい部品の価格を1回の呼び出しで見積もります。STEP ファイル、またはシートの厚さと材質を指定した DXF の展開図を使用し、PDF 図面は任意で追加できます。計算が成功した場合のみクォータを消費します。	write
get_upload_link	お使いのコンピューターにあるファイルをアップロードするための ARCNM アップロードページへのリンクです。	read
quote_part	ARCNM に登録済みの部品について、ロットサイズ、材質、原価計算環境を変更して再見積もりします。複数の環境を一度に指定することもできます。計算が成功した場合のみクォータを消費します。	write

進行状況を確認する、または停止する

ツール	機能
get_calculation	1件の計算について、ステータス、実行中の残り時間、価格算出後の結果を返します。	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	2件の計算では価格差を返し、3～20件では順位付けします。	read

参照

ツール	機能
list_environments	組織の原価計算環境を一覧表示します。	read
check_quota	組織の残りの計算クォータを確認します。	read

この15個のツールはいずれも削除を行いません。直接アップロード、部品、順位付きコスト要因、原価計算環境と条件変更、板金用ジョブネスト、材質および工具のカタログ、キャリブレーション、フォルダーなどの追加ツールは、クライアントが必要なツールセット、または all を指定した X-MCP-Toolsets ヘッダーを送信すると一覧表示されます。ツールセットをご覧ください。

プロンプト

サーバーには、エージェントが一連の作業を進めるための5つのプロンプトも付属しています。 cost_a_part、compare_calculations、compare_environments、explain_cost、 find_cost_drivers です。

試してみる

• 「この STEP ファイルをロットサイズ1、10、100で見積もり、コストの内訳を教えてください。」
• 「この部品のコストを左右する要因を3つ挙げ、それらを変えるにはどうすればよいか教えてください。」
• 「このブラケットを当社の原価計算環境ごとに比較し、どこで製造すべきか教えてください。」
• 「総コストが最も低くなるロットサイズはいくつですか？」

サポート

ご質問や問題がある場合は、[email protected] までお問い合わせいただくか、こちらでイシューを作成してください。ドキュメント：arcnm.io/docs/mcp。 実行可能な API の例：arcnm/arcnm-examples。

ARCNM は、ドイツのユーバーリンゲンにある rattle mng GmbH が開発しています。