uMCP

uMCP

uMCP は、Unity で AI を活用するために設計された、MCP プロトコルのサーバー実装です。
AI エージェントを Unity アプリケーションに接続するために使用できる、最小限かつ効率的なサーバーです。

特長

• 安全性：uMCP では AI に任意のコードを実行させることはできません。あらゆる操作は、事前に許可された操作を通じてのみ実行できます。
• 拡張性：uMCP は容易に拡張できるように設計されており、McpServerToolType 属性と McpServerTool 属性を使って、独自のカスタムコマンドや操作を追加できます。
  • 例は Assets/NatsunekoLaboratory/ModelContextProtocol/ManagementTools ディレクトリで確認できます。

仕組み（他の MCP 実装との違い）

uMCP は、他の依存関係を必要とせず、Streamable HTTP プロトコルを使用して MCP クライアントと直接通信できます。 そのため、Python、Node.js、その他の言語ランタイムなどの追加依存関係を必要とする他の MCP サーバーと比較して、より効率的で軽量な実装を実現できます。

Your MCP Client <-- Streamable HTTP --> uMCP Server

インストール

前提条件

• Unity Editor：バージョン 2022.3 LTS 以降。
• MCP クライアントが Streamable HTTP に対応している必要があります（例：VSCode Agent Mode、Cursor、CLINE など）。

1. CoreFramework をインストールする

Unity Package Manager を使用する場合

1. openupm add com.natsuneko.modelcontextprotocol.core-framework
2. Unity プロジェクトを開きます。

Git URL を使用する場合

1. Unity プロジェクトを開きます。
2. Window > Package Manager を開きます。
3. + をクリックして、Add package from git URL... を選択します。
4. URL を入力します：

   https://github.com/mika-f/uMCP.git?path=/Assets/NatsunekoLaboratory/ModelContextProtocol/CoreFramework
   

5. Add をクリックします。
6. Unity プロジェクトを実行すると、MCP サーバーが自動的に起動します。

2. Management Tools（およびその他のパッケージ）をインストールする

Unity Package Manager を使用する場合

• openupm add com.natsuneko.modelcontextprotocol.management-tools
• openupm add com.natsuneko.modelcontextprotocol.vrchat-world-tools

Git URL を使用する場合

1. Unity プロジェクトを開きます。
2. Window > Package Manager を開きます。
3. + をクリックして、Add package from git URL... を選択します。
4. URL を入力します：

   https://github.com/mika-f/uMCP.git?path=/Assets/NatsunekoLaboratory/ModelContextProtocol/MagagementTools
   

5. Add をクリックします。

3. MCP クライアントを設定する

Streamable HTTP に対応した MCP クライアント（VSCode Agent Mode、Cursor、CLINE など）を MCP サーバーに接続します。

http://localhost:7225/sse
# or
http://localhost:7225/mcp

VSCode Agent Mode の例：

{
  "servers": {
    "uMCP": {
      "url": "http://localhost:7225/mcp"
    }
  }
}

使用方法

1. Unity プロジェクトを開きます。
2. MCP クライアント（VSCode Agent Mode、Cursor、CLINE など）を起動します。
3. 操作を開始します。これで MCP クライアントが Unity アプリケーションと通信できるようになります。

拡張

独自のカスタムコマンドや操作を作成して、uMCP を拡張できます。

using System;
using System.ComponentModel;

using NatsunekoLaboratory.ModelContextProtocol.CoreFramework.Attributes;
using NatsunekoLaboratory.ModelContextProtocol.CoreFramework.Models;
using NatsunekoLaboratory.ModelContextProtocol.CoreFramework.Protocol.Abstractions;
using NatsunekoLaboratory.ModelContextProtocol.CoreFramework.Protocol.Interfaces;

namespace NatsunekoLaboratory.Examples.MyCustomCommands
{
    [McpServerToolType]
    public class MyCustomCommand
    {
        [McpServerTool]
        [Description("This is a custom command that does something.")]
        public static IToolResult Execute([Description("An example parameter for the custom command.")] string exampleParameter)
        {
            // Your custom command logic here
            return new TextResult($"Executed custom command with parameter: {exampleParameter}");
        }
    }
}

ライセンス

@6jz による MIT