🚀 Unity MCP 服务器
Unity MCP 服务器用于将 Claude 连接到 Unity 项目，它基于 Model Context Protocol SDK 构建，为开发者提供了便捷的项目管理与访问途径。
🚀 快速开始
本服务器旨在将 Claude 与 Unity 项目连接起来，借助它可以方便地列出所有 Unity 项目、获取项目详细信息以及访问项目结构和文件。
✨ 主要特性
- 列出所有 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 工作，请打开问题。以下是一些提示：
- 确保已安装 Unity 并且配置了一些项目
- 检查 unity-mcp 服务器是否可以访问 projects-v1.json 文件
- 确保对 Unity 项目目录有适当的权限
此 MCP 将日志输出到标准错误，符合 MCP 规范。在 MacOS 上，Claude Desktop 应用会将这些日志输出到 ~/Library/Logs/Claude。在其他平台上，你可以在此处找到日志。
💻 使用示例
基础用法
使用 NPX 快速运行：
npx unity-mcp@latest
高级用法
本地克隆仓库并运行：
git clone https://github.com/your-username/unity-mcp.git
cd unity-mcp
bun install
bun run src/index.ts
📚 详细文档
开发
设置
# 安装依赖项
bun install
# 运行项目
bun run src/index.ts
# 类型检查
bun run typecheck
# 格式化代码
bun run format
调试
由于 MCP 服务器通过标准输入输出运行，调试可能具有挑战性。为了获得最佳的调试体验，我们强烈推荐使用 MCP Inspector。 可以使用以下命令启动 MCP 检查器：
bun run inspector
启动后，检查器会显示一个 URL，可以在浏览器中访问以开始调试。
📄 许可证
MIT License - 有关详细信息，请参阅 LICENSE 文件。