Genshin Miliastra MCP — AI skill for Claude Code

genshin-miliastra-mcp · 原神千星奇域游戏制作 MCP 服务器

**让 AI 替你做千星奇域的关卡。** Miliastra Wonderland MCP Server for Genshin Impact UGC · [English](README.en.md)

给支持 MCP（Model Context Protocol）的 AI 用的《原神》千星奇域创作工具。你在自己的电脑上开着千星奇域的编辑器（千星沙箱），Claude、Cursor、Codex 这类 AI 接上这套工具替你搭关卡：搜物件摆场景、设关卡、写节点图（TypeScript，用 **Genshin-TS 0.2.2** 编译）、自动试玩并拿回日志和截图。

上面三局是三个没参与过开发的 AI 各自只拿到这套工具、从空白地图做出来并按脚本打通的（[经过和它们卡在哪](docs/BLIND_TEST_2026-10-13.zh-CN.md)）。

**AI 自己进游戏试玩。** 下面这段是工具录的：一局用客户端 Lua 写的翻牌配对（[examples/pairs](examples/pairs)），工具把它写进存档、打开游戏、照脚本点暂停、继续、翻完十二张牌，一直打到游戏自己的胜利画面，再把日志和画面拿回来对照。没有人碰鼠标。


它能做什么

• **搭场景**：2468 种官方物件的图鉴，按名字搜、看缩略图，一次导入一百个物件；锁定视角、出生点、复苏点、昼夜和灯光。

• **做机关和怪**：元件、碰撞触发器、按 F 交互、移动平台、弹跳垫、力场、隐形墙、投射物和命中检测、会自己找敌人打的复杂造物、技能、道具、商店、货币。

• **做界面**：进度条（横条、竖条、圆环）、图片（约 1600 张平台自带的图）、计时器、按钮。

• **写客户端 Lua**（游戏 7.1 的新能力）：会动、能收鼠标和按键的界面，甚至整局 2D 小游戏；脚本的打印和节点图的打印一起从试玩里拿回来。

  

• **写规则**：节点图用 TypeScript 写，一次编译几十张图写进存档；自带节点文档、特效（3195 条）、音效（1997 条）、音乐（188 条）的中文目录。

• **自己试玩**：按脚本按键、点鼠标、把玩家放到指定位置，截图、连拍、录音、录像，读回日志；AI 靠这个知道做出来的东西在游戏里到底对不对。

• **发布前的准备**：出封面、截图、标题和简介。发布本身由你在游戏里点。

• **离线知识库**：官方综合指南、教程、48 份官方教学存档的拆解，加上一份实测出来的平台规则，AI 设计玩法前先查。

自带的图鉴：缩略图和编号

千星奇域里的物件、特效、音效、图片，在存档和节点图里都是靠编号引用的。编号在编辑器里看得到，但本地数据里没有现成的表可查。这个仓库把它们整理成了图鉴，大部分是从编辑器里一样一样读出来、拍下来的，AI 按中文名字就能查到编号、看到长相再挑：


图鉴	数量	内容	文件
物件	2468 种，其中 2398 种有缩略图	编号、名字、分组、尺寸（名单和尺寸来自 qianxing-format-docs，CC BY 4.0）；缩略图是摆进编辑器里逐个实拍的	src/scene/asset-catalog.json、src/scene/thumbs/<编号>.jpg
特效	3195 条（限时 1986、循环 1209）	编号、名字、每条在资产库里的小图；87 个循环特效另有挂在角色身上的实拍	src/scene/media/effects.json、fx-thumbs.*、src/scene/fx/