Back to MCP directory
publicPublicdnsLocal runtime

unity-mcp-template

Unity MCP模板是一个展示TypeScript MCP服务器与Unity交互的示例项目,支持自定义工具开发,包含快速启动指南和待办列表。

article

README

🚀 Unity MCP 模板

本项目是一个简单示例,展示了基于 TypeScript 的 MCP 服务器与 Unity 之间的交互。你可以基于此构建和配置自己的工具,实现功能的进一步扩展和发展。快来创建属于你自己的工具吧!

mcp-template-ezgif com-resize

🚀 快速开始

unity-mcp-sample 是一个 Unity 示例项目。为了最小化版本相关问题,确保与旧版本兼容,该项目未使用 NewtonsoftJSON 等包。此外,EditorWindow 使用 IMGUI 实现。你可以通过顶部的 UnityMCP - ShowWindow 对 MCP 进行管理。

📦 构建 MCP 服务器

在 unity-mcp-server 目录下,执行以下命令:

npm install
npm run build

📥 在 Claude Desktop 中添加 MCP

打开 Claude Desktop 设置,编辑配置文件:

{
    "mcpServers": {
      "unity-mcp": {
        "command": "node",
        "args": ["F:/unity-mcp-template/unity-mcp-server/dist/index.js"]
      }
    }
  }

✨ 创建你自己的工具!

输入数据结构需与现有结构保持一致。

💻 Unity

参考 CreateObjectTools 来创建你所需的工具。

💻 Typescript

参考 createObject 来创建你所需的工具。

📋 待办事项列表

  • [x] 启用 Unity 发送结果消息到 MCP
  • [ ] 此处讨论 ~~更改 TCP 结构(当前由于 TypeScript SDK 中的错误,MCP 服务器和客户端角色相反)~~
    • ~~Unity(当前:TCP 服务器,TODO:TCP 客户端)~~
    • ~~MCP(当前:TCP 客户端,TODO:TCP 服务器)~~
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client