Unity MCP

Unity MCP サーバー

Claude と Unity プロジェクトを接続する MCP サーバーです。 Model Context Protocol SDK を使用して構築されています。

機能

• すべての Unity プロジェクトを一覧表示
• プロジェクトの詳細情報を取得
• プロジェクトの構造とファイルにアクセス

インストールと使用方法

オプション 1：NPX を使用する（推奨）

インストールせずに、npx でこのツールを直接実行できます。

npx unity-mcp@latest

このツールを Claude の MCP サーバーとして追加します。

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": ["unity-mcp@latest"]
    }
  }
}

オプション 2：このプロジェクトをローカルで実行する

または、このリポジトリをクローンして、プロジェクトをローカルで実行します。

git clone https://github.com/your-username/unity-mcp.git
cd unity-mcp
bun install

次に、ローカル版を使用するように Claude を設定します。

{
  "mcpServers": {
    "unity": {
      "command": "bun",
      "args": ["run", "C:\\Users\\Artga\\Code\\unity-mcp\\src\\index.ts"]
    }
  }
}

必要条件

• プロジェクトが設定された Unity
• Bun ランタイム

トラブルシューティング

この MCP が動作しない場合は、Issue を作成してください。以下の点をご確認ください。

1. Unity がインストールされ、いくつかのプロジェクトが設定されていることを確認します
2. unity-mcp サーバーが projects-v1.json ファイルにアクセスできることを確認します
3. Unity プロジェクトのディレクトリに対する適切な権限があることを確認します

この MCP は、MCP 仕様に従ってログを stderr に出力します。Mac では、Claude Desktop アプリのログは ~/Library/Logs/Claude に出力されます。それ以外のプラットフォームでは、 こちらでログを確認できます。

開発

セットアップ

# Install dependencies
bun install

# Run the project
bun run src/index.ts

# Type check
bun run typecheck

# Format code
bun run format

デバッグ

MCP サーバーは stdio 経由で実行されるため、デバッグが難しい場合があります。最適なデバッグ環境を利用するには、 MCP Inspector の使用を強くおすすめします。

次のコマンドで MCP Inspector を起動できます。

bun run inspector

起動すると、Inspector に URL が表示されます。その URL にブラウザーからアクセスすると、デバッグを開始できます。

ライセンス

MIT License — 詳細は LICENSE ファイルをご覧ください。