Naninovel MCP服务器
Unity C#插件，通过模型上下文协议（MCP）公开Naninovel脚本创作和播放控件，使AI助手能够编写、编辑和测试视觉小说脚本。
特性
- 独立于游戏模式 -服务器始终在编辑器中运行
- NaniScript CRUD -创建、读取、更新、删除脚本文件
- 直接播放 -跳过标题屏幕，跳到任何脚本/标签
- 输入模拟 -高级对话，模拟按键
- 目视验证 -用于场景验证的屏幕截图
快速开始
- 打开Unity编辑器
- 服务器自动启动（或打开 窗口>Nani MCP>服务器状态)
- 将您的MCP客户端连接到
http://localhost:6274
对于Antigravity，添加到您的 mcp_config.json:
{
"mcpServers": {
"nani-mcp": {
"serverUrl": "http://localhost:6274"
}
}
}
可用工具
脚本文件操作（编辑器模式）
| 工具 |
说明 |
list_scripts |
列出Scenarios文件夹中的所有.nani文件 |
read_script |
读取脚本文件的内容 |
write_script |
创建或覆盖脚本文件 |
edit_script |
在脚本中插入、替换或删除行 |
delete_script |
删除脚本文件（带备份） |
播放控制（播放模式）
| 工具 |
说明 |
quick_play |
直接播放脚本，绕过标题屏幕 |
execute_command |
执行单个Nani命令 |
play_script |
加载并播放脚本 |
stop_player |
停止当前播放 |
goto_label |
跳转到特定标签 |
get_playback_status |
获取当前播放状态 |
场景和状态（播放模式）
| 工具 |
说明 |
capture_screenshot |
将当前游戏视图捕获为PNG |
get_scene_state |
获得可见的演员和职位 |
get_variables |
列出所有自定义变量 |
set_variable |
设置变量值 |
输入模拟（播放模式）
| 工具 |
说明 |
continue_dialogue |
前进到下一条对话线 |
simulate_key |
模拟键盘按键 |
simulate_click |
模拟鼠标点击 |
Unity编辑器控件
| 工具 |
说明 |
enter_play_mode |
启动Unity播放模式（从标题屏幕） |
exit_play_mode |
停止Unity播放模式 |
get_unity_status |
获取Unity编辑器状态和播放模式状态 |
list_scenes |
在构建设置中列出所有Unity场景 |
示例：编写脚本
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "write_script",
"arguments": {
"path": "events/new_scene.nani",
"content": "; New Scene\n@back Classroom\n@char NaniChan\nNaniChan: Bonjour!"
}
}
}
示例：快速播放
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "quick_play",
"arguments": {
"script": "events/new_scene",
"resetState": true
}
}
}
配置
打开 窗口>Nani MCP>服务器状态 配置：
- 端口：WebSocket服务器端口（默认值：6274）
- 自动启动：编辑器打开时自动启动服务器
许可证
MIT许可证
