Umcp

🚀 uMCP

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

✨ 主な機能

• 安全性：uMCPはAIに任意のコードを実行させることはできず、すべての操作は事前に承認された操作を通じてのみ実行できます。
• 拡張性：uMCPは容易に拡張できるように設計されており、McpServerToolType と McpServerTool 属性を介して独自のカスタムコマンドと操作を追加できます。
  • Assets/NatsunekoLaboratory/VMCP ディレクトリに例を見つけることができます。

🔧 仕組み（他の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. UnityPackageのインストール

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

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

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

2. MCPクライアントの設定

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

http://localhost:7225/sse

VSCode Agent Modeの例：

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

💻 使用例

基本的な使用法

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

高度な使用法

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

using System;
using System.ComponentModel;

using NatsunekoLaboratory.uMCP.Protocol.Attributes;
using NatsunekoLaboratory.uMCP.Protocol.Abstractions;
using NatsunekoLaboratory.uMCP.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ライセンス