mcp-source について
Unity プロジェクトの `com.coplaydev.unity-mcp` パッケージソースを切り替えるスキルです。対象の manifest を特定し、選択したソースの URL を組み立てて依存関係を更新します。
主な機能
- 01main、beta、branch、local のソース選択
- 02MCP リソースによる Unity プロジェクトの検出
- 03ファイルシステムを使った manifest の検索
- 04リポジトリ情報に基づくパッケージ URL の生成
- 05manifest 内の依存値の更新
活用シーン
- 01安定版または beta のパッケージソースの利用
- 02Unity プロジェクトで pull request ブランチをテスト
- 03プロジェクトをローカルのパッケージチェックアウトに接続
MCP 対応
`mcpforunity://project/info` を読み、利用可能な MCP リソースを列挙して接続済みの Unity プロジェクトを特定します。接続がない場合はファイルシステムを検索します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ coplaydev/ unity-mcp --skill mcp-sourceインストール後、Claude Code で/mcp-sourceを入力して読み込まれたか確認します。
詳細
Unity パッケージソースの切り替え
1 つ以上の Unity プロジェクトで、com.coplaydev.unity-mcp パッケージのソースを切り替えます。
allowed-tools
Bash, Read, Edit, ReadMcpResourceTool, ListMcpResourcesTool
手順
1. 引数を解析する
ユーザーの引数は $ARGUMENTS です。
有効な値:main、beta、branch、local、または空。
空の場合、または 4 つの有効な値のいずれでもない場合は、ユーザーに選択を求めます。
- main — upstream の main ブランチ(安定版リリース)
- beta — upstream の beta ブランチ(プレリリース)
- branch — 現在のリモートブランチ(PR のテスト用)
- local — チェックアウト先へのローカルファイル参照(開発中の反復作業用)
2. リポジトリのコンテキストを検出する
現在の作業ディレクトリから次の git コマンドを実行して、unity-mcp リポジトリを探します。
git rev-parse --show-toplevel # → repo_root
git rev-parse --abbrev-ref HEAD # → branch_name
git remote get-url origin # → origin_url
SSH の origin を HTTPS に変換します。origin_url が [email protected]: で始まる場合は、https://github.com/{owner}/{repo}.git に変換します。
3. 対象の Unity プロジェクトを見つける
更新対象の Packages/manifest.json ファイルを見つけるため、次の 2 つの方法を試します。
方法 A — MCP リソース(優先):
接続されている各 Unity インスタンスについて mcpforunity://project/info を読み取ります(ListMcpResourcesTool を使って利用可能なインスタンスを探します)。projectRoot を抽出し、{projectRoot}/Packages/manifest.json を使用します。
方法 B — ファイルシステムでのフォールバック:
接続されている MCP インスタンスがない場合は、Bash を使って現在の作業ディレクトリから上位に向かい、Packages/manifest.json ファイルを検索します。
find "$(pwd)" -maxdepth 3 -name "manifest.json" -path "*/Packages/manifest.json" 2>/dev/null
manifest が複数見つかった場合は、ユーザーに事前確認したうえですべて更新します。
4. パッケージ URL を構築する
ユーザーの選択に基づいて、依存関係の値を構成します。
| 選択 | URL |
|---|---|
main | https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main |
beta | https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#beta |
branch | {origin_https}?path=/MCPForUnity#{branch_name} |
local | file:{repo_root}/MCPForUnity |
branch の場合:HTTPS に正規化した origin URL と、現在の git ブランチ名を使用します。
local の場合:file: を先頭に付けたリポジトリルートの絶対パスを使用します(// は付けません)。例:file:/Users/davidsarno/unity-mcp/MCPForUnity
5. 各 manifest を更新する
見つかった manifest.json ごとに、次の手順を実行します。
- Read ツールでファイルを読み取ります
"com.coplaydev.unity-mcp"の依存関係の行を見つけます- Edit ツールを使って、古い値を新しい URL に置き換えます
- 変更内容を報告します:古い値 → 新しい値、ファイルパス
6. 結果を報告する
更新後、ユーザーに次の内容を伝えます。
- 更新した manifest
- 古いパッケージソースの値と新しい値
- 次の注意事項:「Unity はパッケージを自動的に再解決します。再解決されない場合は、Package Manager を開いて Refresh をクリックしてください。」