Maya MCP

Autodesk Maya 用 Maya MCP サーバー

Maya MCP は、Maya の commandPort を通じて Autodesk Maya を操作する、オープンソースのローカル Model Context Protocol サーバーです。

対応する Maya のバージョン：Autodesk Maya 2024 以降。

サーバープロセスに Maya モジュールをインポートせずに、シーンの作業、ノード、選択、モデリング、シェーディング、スキニング、アニメーション、カーブ、スクリプト、ビューポートのキャプチャを行える、型付きツールを MCP クライアントに提供します。

このプロジェクトは非公式であり、Autodesk との提携や推奨を受けていません。Autodesk Maya は Autodesk, Inc. の商標です。

選ばれる理由

• Maya の外部で実行されるため、サーバーは Maya のインポートから分離された状態を保ちます
• Maya とは localhost 経由でのみ通信します
• 生の API 呼び出しではなく、71 個の型付きツールを公開します
• 未保存の変更がある場合に、より安全にシーンを置き換える手順に対応しています
• 明示的に有効にしない限り、生コードの実行は無効です

Claude Desktop のクイックスタート

Claude Desktop では、パッケージ化された MCPB 拡張機能を最新の GitHub リリースから入手してください。

1. リリースの Assets セクションから maya-mcp-<version>.mcpb をダウンロードします。
2. .mcpb ファイルをダブルクリックするか、Claude Desktop にドラッグするか、Settings -> Extensions -> Advanced settings -> Install Extension を使用して、Claude Desktop にインストールします。
3. 別のポートを使用する場合を除き、Maya の commandPort 設定は 7001 のままにします。
4. Maya を開き、次のセクションに記載された commandPort のセットアップを実行します。
5. Claude Desktop で health_check、scene_info、nodes_list を使って動作を確認します。

Claude Desktop では scene_info のようなアンダースコア形式のツール名を使います。他の MCP クライアントでは scene.info のようなドット形式の名前を使います。

クイックスタート

1. インストール

pip install maya-mcp

Windows の場合：

py -m pip install maya-mcp

ソースからインストールする場合：

pip install -e ".[dev]"

2. Maya の commandPort を開く

scripts/enable_commandport.py ファイル全体をダウンロードし、Maya の Python Script Editor に貼り付けて実行します。このヘルパーは、Maya 2025 以降では既存の Python + echoOutput の経路を維持します。Maya 2024 でのみ、そのリリースで必要となるループバック限定の応答互換経路を選択します。

3. サーバーを起動する

maya-mcp

その他の対応している起動方法：

python -m maya_mcp.server
python src/maya_mcp/server.py
fastmcp run

このリポジトリには fastmcp.json が含まれているため、fastmcp run を使用できます。

4. クライアントに追加する

Codex CLI / IDE 拡張機能

Codex は MCP サーバーの設定に ~/.codex/config.toml を使用します。CLI と IDE 拡張機能は同じ設定を共有します。

インストール済みパッケージ：

[mcp_servers.maya]
command = "maya-mcp"

ソースのチェックアウトまたは Windows で使いやすいセットアップ：

[mcp_servers.maya]
command = "py"
args = ["-m", "maya_mcp.server"]
env = { PYTHONPATH = "src" }

ソースのチェックアウトから実行する場合に限り、PYTHONPATH の行を使用してください。 Windows ランチャーが用意されていないプラットフォームでは、py の代わりに python を使用してください。

Claude Code

Claude Code のプロジェクトスコープの MCP サーバーは .mcp.json に記述します。 サーバーキーはユーザーが定義します。以下の例では一貫して maya を使用しています。

パッケージをインストール済みの場合：

{
  "mcpServers": {
    "maya": {
      "command": "maya-mcp",
      "args": []
    }
  }
}

ソースをチェックアウトした場合、または Windows 向けのセットアップ：

{
  "mcpServers": {
    "maya": {
      "command": "py",
      "args": ["-m", "maya_mcp.server"],
      "env": {
        "PYTHONPATH": "src"
      }
    }
  }
}

Windows で Codex CLI と Claude Code を使用する場合は、maya-mcp コンソールスクリプトが正しい PATH にあることに頼るより、通常は py -m maya_mcp.server のほうが確実です。

Claude Desktop Extension

Maya MCP は Claude Desktop の MCPB 拡張機能として提供されています。この拡張機能は引き続き同じローカルの stdio サーバーを実行し、Maya との通信を localhost 上で行います。

ユーザー向けのインストール、ビルド、検証、トラブルシューティングの説明は Claude Desktop Extension にあります。

公開される GitHub Releases には、リリースワークフローがバンドルを検証してスモークテストした後、ビルド済みの .mcpb パッケージが maya-mcp-<version>.mcpb として添付されます。

パッケージスクリプトは、ユーザーのローカルにインストールされた MCPB CLI に対応しています：

npm install --prefix "$env:USERPROFILE\.tools\mcpb" @anthropic-ai/mcpb
.\packaging\claude-mcpb\build.ps1

VS Code

VS Code では、servers オブジェクトを含む .vscode/mcp.json を使用します。

{
  "servers": {
    "maya": {
      "type": "stdio",
      "command": "maya-mcp"
    }
  }
}

その他の MCP クライアント

一部のクライアントでは、汎用の mcpServers オブジェクトを使用します：

{
  "mcpServers": {
    "maya": {
      "command": "maya-mcp",
      "args": []
    }
  }
}

5. 検証

以下のツールを順番に呼び出します：

1. health.check
2. scene.info
3. nodes.list

ツールの対応状況

分類	数
health	1
maya	2
scene	9
nodes	7
attributes	2
selection	6
connections	5
mesh	3
viewport	1
modeling	15
shading	3
skin	6
animation	6
curve	2
script	3

script.run はデフォルトで無効になっており、MAYA_MCP_ENABLE_RAW_EXECUTION=true が必要です。

scene.new と scene.open は、現在のシーンに未保存の変更がある場合、引き続きデフォルトで処理を拒否します。MCP のフォームエリシテーションを通知するクライアントでは、force=True を指定して再試行する代わりに、インバンドで変更破棄の確認を受け取ることができます。

主なドキュメント

• ドキュメントのホーム
• はじめに
• クライアントのセットアップ
• Claude Desktop Extension
• ツールガイド
• アーキテクチャ概要
• トランスポート仕様
• セキュリティ仕様
• プライバシーポリシー
• API リファレンス

公開ドキュメント：https://gimbalgoats.github.io/GG_MayaMCP/

開発

このリポジトリでは、Windows での Python コマンドに py を使用します：

py -m ruff check .
py -m ruff format .
py -m mypy src/
py -m pytest

テストがこのリポジトリではなく site-packages から maya_mcp をインポートする場合：

$env:PYTHONPATH='src'
py -m pytest

セキュリティに関する注意

• localhost のみ
• リモートホストには対応していません
• MCP サーバープロセスで Maya をインポートしません
• 任意のコード実行はデフォルトで無効です
• クライアント向けのエラーにシークレットや未加工のトレースバックは含まれません

プライバシー

Maya MCP はローカルで動作します。このプロジェクトはホスト型サービスを運営せず、テレメトリーを収集せず、ローカルでの使用から Maya のシーンデータを受け取りません。 プライバシーポリシーをご覧ください。

ライセンス

MIT。LICENSEをご覧ください。