Unity MCP

Unity MCP Server

用于将 Claude 与 Unity 项目连接的 MCP 服务。使用 Model Context Protocol SDK 构建。

功能

• 列出所有 Unity 项目
• 获取详细的项目信息
• 访问项目结构和文件

安装与使用

选项 1：使用 NPX（推荐）

无需安装，即可通过 npx 直接运行此工具：

npx unity-mcp@latest

在 Claude 中将此工具添加为 MCP 服务：

MacOS：~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": ["unity-mcp@latest"]
    }
  }
}

选项 2：在本地运行此项目

或者，克隆此代码库并在本地运行此项目：

git clone https://github.com/your-username/unity-mcp.git
cd unity-mcp
bun install

然后配置 Claude 使用本地版本：

{
  "mcpServers": {
    "unity": {
      "command": "bun",
      "args": ["run", "C:\\Users\\Artga\\Code\\unity-mcp\\src\\index.ts"]
    }
  }
}

要求

• Unity 已安装并配置了项目
• Bun 运行时

故障排除

如果无法使用此 MCP，请提交 issue。以下是一些建议：

1. 确保已安装 Unity 并配置了一些项目
2. 检查 unity-mcp 服务能否访问 projects-v1.json 文件
3. 确保对 Unity 项目目录拥有适当的权限

此 MCP 会按照 MCP 规范将日志输出到 stderr。在 Mac 上，Claude Desktop 应用会将这些日志输出到 ~/Library/Logs/Claude。在其他平台上， 可在此处查找日志。

开发

设置

# Install dependencies
bun install

# Run the project
bun run src/index.ts

# Type check
bun run typecheck

# Format code
bun run format

调试

由于 MCP 服务通过 stdio 运行，调试可能颇具挑战。为获得最佳调试体验，我们强烈建议使用 MCP Inspector。

可使用以下命令启动 MCP Inspector：

bun run inspector

启动后，Inspector 会显示一个 URL，你可以在浏览器中访问该 URL 开始调试。

许可证

MIT License——详情请参阅 LICENSE 文件。