uMCP

uMCP

uMCP 是 MCP 协议的服务端实现，旨在用于在 Unity 中与 AI 协作。
这是一个简约高效的服务，可用于将 AI Agent 连接到 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}");
        }
    }
}

许可证

MIT，由 @6jz 提供