内容
<div align="center">
<img src="https://raw.githubusercontent.com/aka-kika/unity-super-mcp/main/assets/logo.png" alt="Unity Super MCP" width="120" />
# Unity Super MCP
**适用于 Unity 游戏服务的单一 MCP 服务器，提供 LiveOps、构建大小分析和商店合规性检查。**
[](LICENSE)
[](https://nodejs.org)
[](server.ts)
[](https://modelcontextprotocol.io)
[](https://unity.com/solutions/gaming-services)
<img src="https://raw.githubusercontent.com/aka-kika/unity-super-mcp/main/assets/demo.gif" alt="Unity Super MCP demo" width="700" />
</div>
一个 MCP 服务器，为 Unity 项目提供 15 种工具：Unity 游戏服务 LiveOps（经济、云存储、云代码）、构建大小和膨胀分析，以及商店合规性检查 — 只需一次安装即可替代四个。
> **为什么存在（请先阅读）。** 本项目是在一次赌博中构建的，以证明代理是否可以有效地驱动 UGS 端到端。这是一个成果。我构建 MCP 服务器和代理基础设施；我不是游戏开发者，这不是一个游戏开发项目。它在这里作为 MCP 工具设计的演示，而不是一个维护的产品。
整个项目通过与移动 AI 助手进行纯文本聊天构建（无文件上传，无 IDE），然后验证：服务器类型检查干净并启动。将其视为参考实现。
## 安装
```bash
npx -y unity-super-mcp
```
<details>
<summary><b>客户端配置</b> — Claude / Cursor / Windsurf</summary>
```json
{
"mcpServers": {
"unity-super": {
"command": "npx",
"args": ["-y", "unity-super-mcp"],
"env": {
"UNITY_PROJECT_PATH": "/path/to/MyGame",
"UNITY_PROJECT_ID": "your-project-id",
"UNITY_SERVICE_KEY_ID": "your-key-id",
"UNITY_SERVICE_SECRET": "your-secret",
"UNITY_ENV_ID": "production"
}
}
}
}
```
</details>
没有 UGS 凭证？只需设置 `UNITY_PROJECT_PATH`，您仍然可以获得 7 个构建/合规性工具。UGS 工具会报告“未配置”而不是失败。
## 工具
### 🎮 UGS LiveOps（8）
| 工具 | 功能 |
|---|---|
| `ugs_get_project_info` | 项目 + 环境信息读取 |
| `economy_list_catalog` | 列出货币、物品、购买记录 |
| `economy_create_currency` | 创建货币 |
| `economy_create_item` | 创建库存物品 |
| `economy_create_shop` | 创建包含物品和成本的商店 |
| `cloudsave_get_player_data` | 读取玩家的云存储数据 |
| `cloudcode_list_modules` | 列出已部署的云代码模块 |
| `cloudcode_deploy_module` | 部署云代码模块 |
### 📦 构建与发布（7）
| 工具 | 功能 |
|---|---|
| `super_health_check` | **首先运行此工具** — 并行运行核心检查，返回摘要和下一步操作 |
| `build_get_last_report` | 最大资产、按扩展名排序的大小、项目总大小 |
| `build_analyze_bloat` | 重复文件、超大文件、`Resources/`滥用、未优化的纹理 |
| `build_fix_imports` | 为纹理导入修复生成 C# 编辑器脚本（或直接编辑 `.meta` 文件，`apply=true`） |
| `assets_find_orphans` | 未引用资产启发式 |
| `build_check_compliance` | Android 目标 SDK、iOS、StreamingAssets 膨胀 |
## 备注
- `super_health_check` 是预期的入口点：一次调用，整个项目信息读取。
- `assets_find_orphans` 是启发式的 — 在删除任何内容之前，请使用 `AssetDatabase.GetDependencies` 进行验证。
- 需要 Node 18+。
## 许可证
MIT。您可以随意使用它。
