Naninovel MCP

🚀 Naninovel MCP Server

Naninovel MCP Server 是一个 Unity C# 插件，它通过模型上下文协议（MCP）提供 Naninovel 脚本创作和播放控制功能，使 AI 助手能够编写、编辑和测试视觉小说脚本。

🚀 快速开始

1. 打开 Unity 编辑器。
2. 服务器会自动启动（也可以打开 Window > Nani MCP > Server Status）。
3. 将你的 MCP 客户端连接到 http://localhost:6274。

若使用 Antigravity，需在 mcp_config.json 中添加以下内容：

{
  "mcpServers": {
    "nani-mcp": {
      "serverUrl": "http://localhost:6274"
    }
  }
}

✨ 主要特性

• 独立于播放模式：服务器始终在编辑器中运行。
• NaniScript 的增删改查：可创建、读取、更新和删除脚本文件。
• 直接播放：跳过标题画面，直接跳转到任何脚本或标签处开始播放。
• 输入模拟：推进对话，模拟按键操作。
• 视觉验证：捕获屏幕截图以验证场景。

📦 安装指南

此部分原文档未提及具体安装步骤，跳过。

💻 使用示例

基础用法

示例：编写脚本

{
  "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
    }
  }
}

高级用法

原文档未提及高级用法相关内容，跳过。

📚 详细文档

可用工具

脚本文件操作（编辑器模式）

播放控制（播放模式）

场景与状态（播放模式）

输入模拟（播放模式）

Unity 编辑器控制

配置

打开 Window > Nani MCP > Server Status 进行配置：

• 端口：WebSocket 服务器端口（默认值：6274）
• 自动启动：在编辑器打开时自动启动服务器

📄 许可证

本项目采用 MIT 许可证。