text-to-cad

gNucleus Text To CAD MCP サーバー

gNucleusは、テキストや画像を編集可能なCADモデルに変換する生成AIプラットフォームです。

このリポジトリには、gNucleus APIに接続するgNucleus Text-To-CAD MCP サーバーが含まれています。MCP クライアントは、gNucleusのGenAIモデルを使用して、テキスト入力からCADパーツやアセンブリを生成できます。

前提条件

• Python 3.7+
• gNucleus Developerアカウント：
  • gNucleus APIキー

セットアップ

1. このリポジトリをクローンします

2. 仮想環境を作成して有効化します（推奨）：

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. 依存関係をインストールします：

   pip install -r requirements.txt
   

4. ルートディレクトリに、次の変数を含む.envファイルを作成します：

   個人ユーザー

   GNUCLEUS_HOST="genai.gnucleus.ai"
   GNUCLEUS_API_KEY=<your-personal-api-key>
   

   エンタープライズユーザー

   GNUCLEUS_HOST="genai.gnucleus.ai"
   GNUCLEUS_API_KEY=<your-team-key>
   GNUCLEUS_ORG_ID=<your-team-id>
   

gNucleus API KEYの取得

1. gNucleusアカウント：https://gnucleus.ai/でサインアップします
2. API KEY：gNucleusで個人用アクセストークンを作成します：
   • ユーザープロフィールに移動します（右上のユーザーアイコンをクリック）
   • 「Account」に移動します
   • 「Generate New API Key」をクリックして、新しいAPI KEYを生成します
   • 各アカウントには、200の無料APIクレジットが付与されます

サーバーの実行

MCP サーバーを起動します：

python main.py

次のコマンドを実行すると、インスペクターを使ってMCP サーバーをテストできます

npx @modelcontextprotocol/inspector python3 main.py

利用可能なMCP ツール

次のMCP ツールを利用できます：

• text_to_cad(input: str) - 入力からCADを生成します

LLMでのプロンプト例

MCPプロトコルに対応するLLMと使用すると、このサーバーを通じて自然言語でgNucleusを操作できます：

1. テキストからCADへ

• 「CADでブロックを描いて」
• 「CADで長さ=80mm、幅=40mm、高さ=20mmのブロックを描いて」
• 「CADで平歯車シャフトを描いて」
• 「CADでnumber_teeth=20の平歯車シャフトを描いて」
• 「CADでエルボーフランジを描いて」
• 「CADでnumber_bolt_holes=4のエルボーフランジを描いて」

i18nに対応しています。プロンプトには任意の言語を使用できます。一般に英語のほうが他の言語より適切に動作しますが、どの言語でもおおむね動作するはずです。

• 中国語：「在CAD中绘制一个大小为10mm的方块」
• スペイン語：「Dibuja un bloque cuadrado de 10 mm en CAD」

2. テキストからアセンブリへ

• 「text-to-cadツールを使ってテーパーローラーベアリングを生成して」
• 「CADでディファレンシャルギアボックスを描いて」

3. CADの結果表示

生成結果には、主要パラメーター、説明を含む設計仕様と、3Dビューアーで表示できる共有URLが含まれます。共有URLの有効期限は24時間です。

Claude Desktopのセットアップ

1. Claude Desktopの設定ファイル（claude_desktop_config.json）を追加または更新します：

仮想Python環境

仮想Python環境を使用する場合は、次の設定を使用します：

{
  "mcpServers": {
    "gnucleus": {
      "command": "/ABSOLUTE/PATH/TO/YOUR/text-to-cad-mcp/.venv/bin/python",
      "args": [
        "/ABSOLUTE/PATH/TO/YOUR/text-to-cad-mcp/main.py"
      ],
      "workingDirectory": "/ABSOLUTE/PATH/TO/YOUR/text-to-cad-mcp",
      "env": {
        "GNUCLEUS_HOST": "genai.gnucleus.ai",
        "GNUCLEUS_API_KEY": "YOUR_API_KEY_HERE",
      }
    }
  }
}

グローバルPython環境

グローバルPython環境を使用し、requirements.txtもグローバルPython環境にインストールした場合は、次の設定を使用します

{
  "mcpServers": {
    "gnucleus": {
      "command": "python",
      "args": [
        "/ABSOLUTE/PATH/TO/YOUR/text-to-cad-mcp/main.py"
      ],
      "workingDirectory": "/ABSOLUTE/PATH/TO/YOUR/text-to-cad-mcp",
      "env": {
        "GNUCLEUS_HOST": "genai.gnucleus.ai",
        "GNUCLEUS_API_KEY": "YOUR_API_KEY_HERE",
      }
    }
  }
}

2. ファイルを保存してClaude Desktopを再起動します

ClaudeにgNucleus Text-To-CADツールが表示されます

3. Claude とチャットして CAD モデルを生成する

Claude とチャットするときに各プロンプトに「in CAD」を追加するか、Claude に「text-to-cad tools」を使うよう指示すると、Claude が Text-To-CAD ツールをより適切に呼び出せるようになります。

生成結果には、Key Parameter、Descriptionを含む設計仕様と、3D 表示ビューアーへの共有リンクが含まれます。共有 URL の有効期限は 24 時間です。チャットメッセージに共有 URL が出力されない場合は、共有 URL を必ず出力するよう Claude に依頼してください。

共有 URL をクリックすると、gNucleus 3D ビューアーに CAD モデルが表示されます。次の操作ができます。

• マウスの左ボタンを押したまま回転
• マウスの右ボタンを押したままパン
• マウスの中ボタンでズーム

例 1：テキストから CAD パーツを生成

• 入力と CAD パーツの設計仕様

• 3D ビューアー内の CAD パーツ

例 2：テキストから CAD アセンブリを生成

• 入力と CAD アセンブリの設計仕様

• 3D ビューアー内の CAD アセンブリ

注：ビューアーからの CAD モデルのダウンロードには、まだ対応していません。モデルをダウンロードするには、https://gnucleus.ai にログインし、すべての機能を使って同じプロンプトをお試しください。

トラブルシューティング

CAD モデル

CAD モデルが正しく表示されない場合や、一部しか生成されない場合は、https://gnucleus.ai にログインして同じプロンプトを入力し、CAD ファイル（例：FreeCAD 形式）をダウンロードしてください。その後、お使いの CAD ソフトウェア（例：FreeCAD）で開いてください。この問題は、多くの場合、パーツの CAD フィーチャーが完全に生成されていないことが原因です。

モデルのリンクとプロンプトを添えて、バグを報告するか、https://gnucleus.ai/contact からお問い合わせいただくこともできます。

セキュリティに関する考慮事項

• .env ファイルを安全に保管し、github に絶対にコミットしないでください
• このサーバーは安全な環境で実行してください