MCP Unity

🚀 MCP Unity プロジェクトドキュメント

MCP Unity プロジェクトは、Unity 環境での開発を支援するためのプラグインです。このドキュメントでは、プラグインのインストール、設定、使用方法、およびトラブルシューティングについて説明します。

🚀 クイックスタート

MCP Unity プラグインをすぐに使い始めるには、以下の手順に従ってください。

📦 インストール

ダウンロードとインストール

1. MCP Unity プラグインをダウンロードします。
2. ファイルを解凍し、適切な場所に配置します。

設定手順

1. Unity エディタを開き、Edit > Project Settingsに移動します。
2. MCP Settingsタブを選択します。
3. Server Locationに、MCP サーバーのパスを指定します。
4. Applyをクリックして設定を保存します。

✨ 主な機能

コア機能

• モデルコンテキストサポート：モデル間のデータ交換を実現します。
• WebSocket通信：リアルタイム通信によりエディタのパフォーマンスを最適化します。

使用ガイド

1. Unity で新しいシーンを作成するか、既存のシーンを開きます。
2. 対象のオブジェクトに MCP コンポーネントを追加します。
3. コンポーネントのパラメータを設定して、プロジェクトの要件に合わせます。

サーバー設定

Node.js のインストール

1. Node.js公式サイトにアクセスし、最新のLTSバージョンをダウンロードしてインストールします。
2. ターミナルでnpmコマンドが使用できることを確認します。

サーバーコードのコンパイル

# Serverディレクトリに移動
cd 絶対パス/To/mcp-unity/Server

# 依存関係をインストール
npm install

# プロジェクトをコンパイル
npm run build

🔧 プラグインのデバッグ

デバッグ設定

1. Unity エディタでデバッグモードを有効にします。
2. ブラウザでlocalhost:8080にアクセスして、デバッグ情報を確認します。

ログ記録

• コンソールログ：デフォルトで有効になっており、ターミナルまたは指定されたファイルに出力されます。
• 詳細ログ：環境変数DEBUG=*を設定することで、詳細ログを有効にできます。

よくある質問

接続問題

1. サーバーが実行中であることを確認します（Unityコンソールをチェック）。
2. ファイアウォールの設定を確認し、ポートがブロックされていないことを確認します。
3. ポート番号が正しいことを検証します（デフォルトは8080）。

サービス起動失敗

• Unityコンソールのエラーメッセージを確認します。
• Node.jsが正しくインストールされ、パスに追加されていることを確認します。
• サーバーディレクトリ内のすべての依存関係が揃っていることを確認します。

サポートとフィードバック

ヘルプが必要な場合や、何か提案がある場合は、GitHubリポジトリに問題を投稿してください。

連絡先：

• LinkedIn：Miguel Tomás
• Discord：gamester7178
• メール：game.gamester@gmail.com

📄 ライセンス

このプロジェクトはMIT Licenseの下で公開されています。

謝辞

以下のプロジェクトの貢献に感謝します。

• Model Context Protocol
• Unity Technologies
• Node.js
• WebSocket-Sharp