exia-scenario-generator MCP Server

This is an MCP server that creates scenario files for the exia novel game engine.
Generate a scenario in the "Kotonoha Sisters Commentary" format and display it in exia.

function

• Generate a scenario in the form of a "Kotoha Sisters Commentary" for a given topic

• Convert the generated scenario into JSON format for exia

• Download exia from GitHub and set it up

• Displaying the generated scenario in exia

Related MCP server: VOICEPEAK MCP Server

Prerequisites

• Node.js v20.x or higher

• OpenAI API Key

• Git

set up

1. Clone or download the repository

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

2. Install required packages

npm install

3. Compile TypeScript (please run this after making any changes)

npm run build

How to use with Claude Desktop

1. Launch Claude Desktop

2. Open the settings screen and add the MCP server

{
  "mcpServers": {
    "exia-scenario-generator": {
      "command": "npx",
      "args": [
        "-y",
        "/path/to/exia-mcp", //（clone した exia-mcp のパスに置き換えてください）
        "--openai-api-key=YOUR_API_KEY", //（OpenAI API キーに置き換えてください）
        "--stdio"
      ]
    }
  }
}

• ※Please replace YOUR_API_KEY with your actual OpenAI API key.

• * If npx cannot be executed, specify the absolute path.例: /path/to/.volta/bin/npx

3. Used in Claude Desktop as follows:

   • Type "Explain quantum computers on exia"

   • The MCP server starts, generates a scenario, and starts exia.

   • The exia application (Electron) starts in a separate window and plays the scenario.

Available Tools

• generateScenario : Generate a scenario from a topic

• setupExia : Download and set up exia

• saveScenario : Save the generated scenario

• exiaVoiceroidExplain : Runs everything from scenario generation to exia startup (recommended)

Notes

• The first time you run it, it will take some time to download and set up exia.

• You will need to prepare your own character images and replace them manually.

  • The exia documentation is here

• Use of the OpenAI API may incur fees

license

MIT