Naninovel MCP Server

Unity C# plugin that exposes Naninovel script authoring and playback controls via the Model Context Protocol (MCP), enabling AI assistants to write, edit, and test visual novel scripts.

Features

Independent of Play Mode - Server runs in Editor at all times
NaniScript CRUD - Create, read, update, delete script files
Direct Playback - Skip title screen and jump to any script/label
Input Simulation - Advance dialogue, simulate key presses
Visual Verification - Screenshot capture for scene validation

Quick Start

Open Unity Editor
Server auto-starts (or open Window > Nani MCP > Server Status)
Connect your MCP client to http://localhost:6274

For Antigravity, add to your mcp_config.json: ``json { "mcpServers": { "nani-mcp": { "serverUrl": "http://localhost:6274" } } } ``

Available Tools

Script File Operations (Editor Mode)

| Tool | Description | |------|-------------| | list_scripts | Lists all .nani files in Scenarios folder | | read_script | Reads content of a script file | | write_script | Creates or overwrites a script file | | edit_script | Insert, replace, or delete lines in a script | | delete_script | Deletes a script file (with backup) |

Playback Controls (Play Mode)

| Tool | Description | |------|-------------| | quick_play | Play a script directly, bypassing title screen | | execute_command | Execute a single Nani command | | play_script | Load and play a script | | stop_player | Stop current playback | | goto_label | Jump to a specific label | | get_playback_status | Get current playback state |

Scene & State (Play Mode)

| Tool | Description | |------|-------------| | capture_screenshot | Capture current Game View as PNG | | get_scene_state | Get visible actors and positions | | get_variables | List all custom variables | | set_variable | Set a variable value |

Input Simulation (Play Mode)

| Tool | Description | |------|-------------| | continue_dialogue | Advance to next dialogue line | | simulate_key | Simulate keyboard key press | | simulate_click | Simulate mouse click |

Unity Editor Controls

| Tool | Description | |------|-------------| | enter_play_mode | Start Unity Play Mode (from title screen) | | exit_play_mode | Stop Unity Play Mode | | get_unity_status | Get Unity Editor status and Play Mode state | | list_scenes | List all Unity scenes in Build Settings |

Example: Writing a Script

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

Example: Quick Play

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "quick_play",
    "arguments": {
      "script": "events/new_scene",
      "resetState": true
    }
  }
}

Configuration

Open Window > Nani MCP > Server Status to configure:

Port: WebSocket server port (default: 6274)
Auto-start: Start server automatically when Editor opens

License

MIT License

naninovel-mcp