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 が機能しない場合は、問題を報告してください。以下はいくつかのヒントです。

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

この MCP は、MCP 規格に準拠して、標準エラーにログを出力します。MacOS では、Claude Desktop アプリがこれらのログを ~/Library/Logs/Claude に出力します。他のプラットフォームでは、ここでログを見つけることができます。

💻 使用例

基本的な使用法

# オプション 1: NPX を使用して実行
npx unity-mcp@latest

高度な使用法

# オプション 2: ローカルで実行
git clone https://github.com/your-username/unity-mcp.git
cd unity-mcp
bun install
bun run src/index.ts

📚 ドキュメント

セットアップ

# 依存関係をインストールする
bun install

# プロジェクトを実行する
bun run src/index.ts

# 型チェックを実行する
bun run typecheck

# コードをフォーマットする
bun run format

デバッグ

MCP サーバーは標準入出力を介して実行されるため、デバッグは難しい場合があります。最適なデバッグ体験を得るために、MCP Inspector の使用を強くお勧めします。 以下のコマンドで MCP インスペクターを起動できます。

bun run inspector

起動後、インスペクターは URL を表示し、ブラウザでアクセスしてデバッグを開始できます。

📄 ライセンス

MIT ライセンス - 詳細については、LICENSE ファイルを参照してください。