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 許可證。