Poly.Pizza MCP

聚。披萨MCP服务器

聚。披萨 可以将3D模型直接导入Unity项目的模型上下文协议（MCP）服务器。

主要功能

• 搜索模型：关键字Poly。在Pizza中搜索3D模型
• Unity导入：自动将搜索到的模型导入Unity项目
• 导入批处理：一次导入多个型号
• 缓存：缓存并重新使用下载的模型
• 自动生成PreFab：在导入的模型中自动创建Unity Prefab
• 自动生成信用：自动记录CC-BY许可模型的信用
• 在Unity UI中设置API密钥：可以直接在Unity编辑器中输入API密钥，无需环境变量

要求

• Node.js 18+
• Unity 2019.4+
• 聚。披萨API钥匙

______________________________________________________________________

安装

1.安装Unity软件包（Package Manager）

在Unity中 窗口>包管理器打开：

1. + 单击按钮
2. 从git URL添加包。。。 选择
3. 输入以下URL：

https://github.com/HaD0Yun/poly-pizza-mcp.git?path=unity-package

2.安装MCP服务器

git clone https://github.com/HaD0Yun/poly-pizza-mcp.git
cd poly-pizza-mcp
npm install
npm run build

3.设置API密钥（使用Unity UI-推荐）

1. 在Unity中 窗户>多边形。披萨MCP 或 聚。披萨>仪表板 单击菜单
2. 获取API密钥 单击按钮 poly.pizza/settings/api在中发放API密钥
3. 将颁发的API密钥粘贴到输入字段
4. 保存API密钥 单击按钮

API密钥 ~/.poly-pizza/config.json存储在中，MCP服务器将自动读取。

3-1.API密钥设置（使用环境变量-替代方案）

要使用环境变量，请：

# Windows
set POLY_PIZZA_API_KEY=your-api-key-here

# macOS/Linux
export POLY_PIZZA_API_KEY=your-api-key-here

4.MCP客户端设置

添加到Claude Desktop或其他MCP客户端的配置文件：

{
  "mcpServers": {
    "poly-pizza": {
      "command": "npx",
      "args": ["-y", "poly-pizza-mcp"],
      "env": {
        "UNITY_PROJECT_PATH": "/path/to/UnityProject"
      }
    }
  }
}

参考：如果API密钥是在Unity Dashboard中设置的， env不必包括在中。

______________________________________________________________________

可用工具

set_api_key

API密钥设置和状态检查

"API 키 상태 확인해줘"
→ set_api_key()

"API 키 설정해줘"
→ set_api_key(apiKey: "your-api-key")

"API 키 삭제해줘"
→ set_api_key(clear: true)

search_models

Poly.在Pizza中搜索模型

"자동차 모델 찾아줘"
→ search_models(keyword: "car", limit: 10)

import_to_unity

将特定模型导入Unity

"이 모델 Unity에 추가해줘: 5EGWBMpuXq"
→ import_to_unity(modelId: "5EGWBMpuXq", createPrefab: true)

batch_import

一次导入多个型号

"이 모델들 전부 임포트해줘"
→ batch_import(modelIds: ["id1", "id2", "id3"])

quick_import

直接导入搜索后的第一个结果

"중세 검 모델 바로 넣어줘"
→ quick_import(query: "medieval sword")

search_and_batch_import

导入整个搜索结果的展开

"나무 모델 5개 찾아서 전부 임포트해"
→ search_and_batch_import(keyword: "tree", limit: 5)

get_popular

查看热门型号列表

"요즘 인기 있는 모델 뭐야?"
→ get_popular(limit: 20)

cache_status

检查和管理缓存状态

"캐시 상태 보여줘" → cache_status(action: "status")
"캐시 비워줘" → cache_status(action: "clear")

______________________________________________________________________

Unity项目结构

当MCP服务器导入模型时，模型将保存为以下结构：

Assets/
└── PolyPizza/
    ├── Models/           # 3D 모델 파일 (.glb, .fbx 등)
    ├── Prefabs/          # 자동 생성된 프리팹
    ├── CREDITS.txt       # 라이선스 크레딧
    └── .signals/         # MCP ↔ Unity 통신용 (자동 관리)

Unity菜单

Unity Editor中提供的菜单：

• 窗户>多边形。披萨MCP：API密钥设置和仪表板
• 聚。披萨>仪表板：API密钥设置和状态检查
• 聚。披萨>刷新资产：刷新资源
• 聚。披萨>打开模特文件夹：打开模型文件夹
• 聚。披萨>打开预制文件夹：打开PreFab文件夹
• 聚。Pizza>从所有模型创建预制件：在所有模型中创建预Fab

______________________________________________________________________

许可信息

Poly.Pizza的型号有两种许可证：

使用CC-BY许可证型号时 CREDITS.txt将自动在中记录信用。 游戏上市时请在积分屏幕中包含相关内容。

______________________________________________________________________

开发

# 개발 모드 (watch)
npm run dev

# 빌드
npm run build

# 실행
npm start

故障排除

API密钥不起作用

• 在Unity中 聚。披萨>仪表板打开并验证是否保存了API密钥
• https://poly.pizza/settings/api验证中的密钥是否有效
• ~/.poly-pizza/config.json 确保文件存在并正确存储API密钥

在Unity中看不到模型

• 验证Unity Editor是否已打开
• Assets > Refresh 或 Poly.Pizza > Refresh Assets 执行
• .signals 验证文件夹中的文件是否已处理

缓存问题

• cache_status(action: "clear")用初始化缓存

______________________________________________________________________

许可证

麻省理工学院

学分

• 聚。披萨 -免费低多边形3D模型
• 由...创建 躲开 （扎克·卢卡雷利）