Exia Scenario

You run an MCP server that creates exia-compatible scenario files for the exia visual novel engine. It generates “Kotoha Sisters Explainer” style scenarios from a given prompt, converts them to exia JSON, and can download and set up exia for playback. This lets you quickly produce and test new scenarios without manual formatting each time.

How to use

You use this MCP server by configuring an MCP client to launch it as a stdio server. The client sends a prompt, the server generates a scenario in exia JSON format, and then launches exia to play the result.

To run it from an MCP client, use the provided stdio configuration. The command runs via npx and points to the local MCP package with your API key supplied in the arguments. Use your own path to the MCP package and a real API key when you deploy.

How to install

Prerequisites: Node.js v20.x or higher, Git, and your OpenAI API key.

Step 1: Clone the MCP server repository.

git clone https://github.com/kokushin/exia-mcp.git
cd exia-mcp

Step 2: Install dependencies.

npm install

Step 3: Build the TypeScript sources.

npm run build

Additional setup and usage notes

Configure Claude Desktop (or any MCP client) to run the MCP server with the following JSON. This launches the server via npx, points to your local exia-mcp, passes your OpenAI API key, and runs in stdio mode.

{
  "mcpServers": {
    "exia-scenario-generator": {
      "command": "npx",
      "args": [
        "-y",
        "/path/to/exia-mcp",
        "--openai-api-key=YOUR_API_KEY",
        "--stdio"
      ]
    }
  }
}

Security and usage notes

First run may take longer as exia is downloaded and set up. You will need to provide your own character images and replace them manually if you want custom visuals. OpenAI API usage may incur costs.

Examples of available tooling and actions

The MCP server exposes functions to generate scenarios, set up exia, save scenarios, and perform end-to-end execution through exia.

Available tools

generateScenario

Creates a scenario from a given topic in the Kokuu Explainer style and returns it in exia JSON format.

setupExia

Downloads and prepares the exia engine for playback of generated scenarios.

saveScenario

Saves the produced scenario to a local or remote store for later playback.

exiaVoiceroidExplain

Runs the full flow from scenario generation to starting exia in a single step for convenience.