Umcp

🚀 uMCP

uMCP 是 MCP 協議的服務器實現，專為在 Unity 中與人工智能協同工作而設計。它是一個簡約高效的服務器，可用於將 AI 智能體連接到 Unity 應用程序。

✨ 主要特性

• 安全性：uMCP 不允許 AI 執行任意代碼，所有操作只能通過預先授權的操作來執行。
• 可擴展性：uMCP 設計為易於擴展，允許你通過 McpServerToolType 和 McpServerTool 屬性添加自定義命令和操作。
  • 你可以在 Assets/NatsunekoLaboratory/VMCP 目錄中找到示例。

🔧 技術細節

uMCP 可以使用可流式傳輸的 HTTP 協議直接與 MCP 客戶端通信，無需任何其他依賴項。與其他依賴於 Python、Node.js 或其他語言運行時等額外依賴項的 MCP 服務器相比，這使得它的實現更加高效和輕量級。

你的 MCP 客戶端 <-- 可流式傳輸的 HTTP --> uMCP 服務器

📦 安裝指南

前提條件

• Unity 編輯器：版本 2022.3 LTS 或更高版本。
• MCP 客戶端必須支持可流式傳輸的 HTTP（例如，VSCode 代理模式、Cursor、CLINE 等）。

1. 安裝 Unity 包

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 客戶端

將支持可流式傳輸的 HTTP 的 MCP 客戶端（VSCode 代理模式、Cursor、CLINE 等）連接到 MCP 服務器。

http://localhost:7225/sse

VSCode 代理模式的示例：

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

💻 使用示例

基礎用法

1. 打開你的 Unity 項目。
2. 啟動你的 MCP 客戶端（VSCode 代理模式、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("這是一個執行特定操作的自定義命令。")]
        public static IToolResult Execute([Description("自定義命令的示例參數。")] string exampleParameter)
        {
            // 你的自定義命令邏輯
            return new TextResult($"使用參數執行自定義命令: {exampleParameter}");
        }
    }
}

📄 許可證

本項目採用 @6jz 發佈的 MIT 許可證。