Meshy AI MCP Server

Meshy AI MCP サーバー

これは、Meshy AI API をラップする Model Context Protocol（MCP）サーバーです。MCP クライアント（Claude Desktop、Cursor、Cline など）から Meshy の生成 3D ツールを直接利用できます。

機能

• テキストから3D：テキストプロンプトから3Dモデルを生成します。
• 画像から3D：参照画像から3Dモデルを作成します。
• 複数画像から3D：複数の参照画像から3Dモデルを作成します。
• リテクスチャ：既存の3Dモデルに新しいテクスチャを適用します。テキストからテクスチャへのツールは、同じリテクスチャ API を呼び出す互換性エイリアスです。
• テキストから画像：テキストプロンプトから画像を生成します。
• 画像から画像：入力画像から新しい画像を生成します。
• モデルの最適化：ジオメトリを再メッシュして最適化します。
• リギング：3D キャラクターをアニメーション用に自動リギングします。
• アニメーション：リギング済みのキャラクターにアニメーションを適用します。
• ストリーミング：時間のかかるタスクの進行状況をリアルタイムで更新します。
• タスクの削除：すべての API カテゴリーのタスクを削除します。

インストール

オプション 1：npx で直接実行（推奨）

グローバルにインストールせず、npx を使ってサーバーを直接実行できます。

{
  "mcpServers": {
    "meshy-ai": {
      "command": "npx",
      "args": [
        "-y",
        "meshy-ai-mcp-server"
      ],
      "env": {
        "MESHY_API_KEY": "your_meshy_api_key_here"
      }
    }
  }
}

オプション 2：クローンしてローカルでビルド

コードを変更する場合や、ローカルソースから実行する場合は、次の手順に従ってください。

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

   git clone <repository-url>
   cd meshy-ai-mcp-server
   

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

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

4. MCP クライアントを設定します：

   MCP クライアントの設定（例：claude_desktop_config.json または VS Code の設定）に、次の内容を追加します。

   {
     "mcpServers": {
       "meshy-ai": {
         "command": "node",
         "args": [
           "/absolute/path/to/meshy-ai-mcp-server/dist/index.js"
         ],
         "env": {
           "MESHY_API_KEY": "your_meshy_api_key_here"
         }
       }
     }
   }
   

設定

このサーバーを使用するには、Meshy AI API キーが必要です。

1. Meshy Dashboard から API キーを取得します。
2. MCP クライアントの設定で、MESHY_API_KEY 環境変数を設定します（上記を参照）。

任意の環境変数

• MESHY_API_BASE：API ベース URL を上書きします（デフォルト：https://api.meshy.ai/openapi）。
• MESHY_STREAM_TIMEOUT_MS：ストリーミング応答のタイムアウト時間をミリ秒で指定します（デフォルト：300000、つまり5分）。

トラブルシューティング

MCP クライアントで initialize 中にサーバーが終了したと報告される場合は、クライアントの設定からサーバープロセスに MESHY_API_KEY が渡されていることを確認してください。クライアントが利用可能なツールを確認できるよう、キーがなくてもサーバーは起動できますが、キーが設定されるまで Meshy API のツール呼び出しは失敗します。

開発

自動リロードを有効にして開発モードでサーバーを実行するには、次のコマンドを実行します。

# Create a .env file
echo "MESHY_API_KEY=your_key_here" > .env

# Run in dev mode
npm run dev

利用可能なツール

• テキストから3D：create_text_to_3d_task、retrieve_text_to_3d_task、list_text_to_3d_tasks、stream_text_to_3d_task、delete_text_to_3d_task
• 画像から3D：create_image_to_3d_task、retrieve_image_to_3d_task、list_image_to_3d_tasks、stream_image_to_3d_task、delete_image_to_3d_task
• 複数画像から3D：create_multi_image_to_3d_task、retrieve_multi_image_to_3d_task、list_multi_image_to_3d_tasks、stream_multi_image_to_3d_task、delete_multi_image_to_3d_task
• テクスチャ再適用：create_retexture_task、retrieve_retexture_task、list_retexture_tasks、stream_retexture_task、delete_retexture_task
• テクスチャリング（テクスチャ再適用の別名）：create_text_to_texture_task、retrieve_text_to_texture_task、list_text_to_texture_tasks、stream_text_to_texture_task、delete_text_to_texture_task — 同じテクスチャ再適用 API です。互換性のため、従来のツール名を維持しています。
• テキストから画像：create_text_to_image_task、retrieve_text_to_image_task、list_text_to_image_tasks、stream_text_to_image_task、delete_text_to_image_task
• 画像から画像：create_image_to_image_task、retrieve_image_to_image_task、list_image_to_image_tasks、stream_image_to_image_task、delete_image_to_image_task
• リメッシュ：create_remesh_task、retrieve_remesh_task、list_remesh_tasks、stream_remesh_task、delete_remesh_task
• リギング：create_rigging_task、retrieve_rigging_task、list_rigging_tasks、stream_rigging_task、delete_rigging_task
• アニメーション：create_animation_task、retrieve_animation_task、list_animation_tasks、stream_animation_task、delete_animation_task
• ユーティリティ：get_balance

ライセンス

MIT