Exia-Scenario-Generator MCP Server: Automate Your Novel Game Scenarios

The exia-scenario-generator MCP (Model Context Protocol) Server, designed for the exia novel game engine, revolutionizes scenario creation. This server automates the generation of scenario files, specifically catering to the popular “Kotoha Sisters explanation” format. By leveraging this tool, developers can significantly reduce the time and effort required to produce engaging and informative content for their games.

This innovative server takes a specified topic and automatically generates a scenario in the style of a Kotoha Sisters explanation, ready to be displayed within the exia game engine. It handles the conversion of the generated scenario into the required JSON format, streamlining the entire workflow. Furthermore, it can even download and set up exia directly from GitHub, making it exceptionally user-friendly.

Key Features:

• Automated Scenario Generation: Takes a specified topic and generates a complete scenario.
• “Kotoha Sisters Explanation” Format: Creates scenarios in the engaging and recognizable style of the Kotoha Sisters.
• exia JSON Conversion: Automatically converts generated scenarios into the JSON format required by the exia game engine.
• exia Setup: Can download and set up exia directly from GitHub, simplifying the initial setup process.
• Seamless Integration with Claude Desktop: Easily integrates with Claude Desktop for a streamlined workflow (explained in detail below).
• Tool Availability: Provides a suite of tools for scenario generation, exia setup, saving, and execution.

Use Cases:

• Rapid Prototyping: Quickly generate scenarios to test game mechanics and narrative ideas.
• Educational Games: Create engaging educational content in the Kotoha Sisters explanation format.
• Content Creation for Novel Games: Automate the creation of large volumes of scenario content for novel games.
• Accessibility: Lower the barrier to entry for creating complex branching narratives in games.
• AI-Assisted Storytelling: Use AI to generate outlines and drafts for interactive stories and visual novels.

Detailed Breakdown of Functionality

The exia-scenario-generator MCP Server operates on a few core principles that simplify the process of content creation. Let’s delve into how each component contributes to the user experience.

1. Scenario Generation with ‘Kotoha Sisters’ Style

   The heart of the server lies in its ability to craft scenarios that mimic the “Kotoha Sisters explanation” format. This style is popular in Japanese media, known for its engaging dialogues, clear explanations, and character-driven narration. By simply providing a topic, the server generates a script complete with character interactions and expository content. The use of AI in generating these scenarios ensures a degree of novelty and variability, preventing repetitive content.

2. JSON Conversion for exia

   The exia game engine requires scenario files to be in JSON format. The server streamlines this process by automatically converting the generated scenario into a compatible JSON structure. This removes the need for manual formatting, which can be tedious and error-prone. This feature is invaluable for developers who want to focus more on the creative aspects of their game.

3. Automated exia Setup

   For new users of the exia engine, setting up the environment can be a daunting task. The server offers a built-in function to download and set up exia directly from GitHub. This eliminates the need to manually download the engine, configure the necessary files, and set up the development environment. It’s a one-click solution that gets users up and running quickly.

4. Integration with Claude Desktop

   One of the most compelling features of the exia-scenario-generator is its seamless integration with Claude Desktop. This integration allows users to interact with the server directly from the Claude Desktop interface. By configuring Claude Desktop to recognize the server, users can initiate scenario generation simply by typing a command like, “exia で量子コンピュータについて解説して” (Explain quantum computers using exia). The server then generates the scenario and launches exia, displaying the content in a separate window.

5. Tool Availability

   The server provides a set of tools that users can leverage:

   • generateScenario: Generates a scenario from a given topic.
   • setupExia: Downloads and sets up the exia engine.
   • saveScenario: Saves the generated scenario to a file.
   • exiaVoiceroidExplain: Combines scenario generation with the exia launch, providing an end-to-end solution.

Getting Started with exia-scenario-generator

To start using the exia-scenario-generator, follow these steps:

1. Prerequisites: Ensure that you have Node.js v20.x or higher, an OpenAI API key, and Git installed on your system.

2. Clone the Repository: Clone the exia-mcp repository from GitHub:

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

3. Install Dependencies: Install the necessary packages using npm:

   bash npm install

4. Compile TypeScript: Compile the TypeScript code (if you’ve made any changes):

   bash npm run build

Integrating with Claude Desktop

To integrate the server with Claude Desktop, follow these steps:

1. Launch Claude Desktop

2. Open the Settings Screen

3. Add the MCP Server Configuration

   Add the following JSON configuration to your Claude Desktop settings:

   { “mcpServers”: { “exia-scenario-generator”: { “command”: “npx”, “args”: [ “-y”, “/path/to/exia-mcp”, // Replace with the path to your cloned exia-mcp “–openai-api-key=YOUR_API_KEY”, // Replace with your OpenAI API key “–stdio” ] } } }

   • Replace YOUR_API_KEY with your actual OpenAI API key.
   • If npx does not work, use the absolute path (e.g., /path/to/.volta/bin/npx).

4. Use the Server in Claude Desktop

   Type a command like “exia で量子コンピュータについて解説して” (Explain quantum computers using exia). The MCP server will start, generate the scenario, and launch exia. The exia application (Electron) will open in a separate window, allowing you to play the scenario.

Important Considerations

• The first time you run the server, it may take some time to download and set up exia.
• Character images need to be provided manually. Refer to the exia documentation for instructions.
• The use of the OpenAI API may incur charges.

License

The exia-scenario-generator MCP Server is released under the MIT license.

The UBOS Advantage: AI Agent Orchestration

While the exia-scenario-generator MCP Server offers a focused solution for automating scenario creation, consider how it can be integrated into a larger, more comprehensive AI ecosystem. This is where UBOS comes in.

UBOS is a full-stack AI Agent Development Platform that empowers businesses to orchestrate AI Agents, connect them with enterprise data, and build custom AI Agents using their own LLM models and Multi-Agent Systems. Think of UBOS as the conductor of an AI orchestra, ensuring that each instrument (or AI Agent) plays its part in harmony.

By integrating the exia-scenario-generator with the UBOS platform, you can unlock a range of new possibilities:

• Automated Content Pipeline: Create a fully automated content pipeline where AI Agents generate scenario outlines, the exia-scenario-generator creates the detailed scenarios, and other agents handle tasks like voiceover generation, image creation, and distribution.
• Personalized Learning Experiences: Use AI Agents to analyze user data and create personalized learning experiences within your novel games. The exia-scenario-generator can then generate scenarios tailored to individual learning styles and preferences.
• Dynamic Storytelling: Develop games with dynamic storylines that evolve based on player interactions. AI Agents can monitor player choices and adapt the narrative in real-time, using the exia-scenario-generator to generate new scenario content on the fly.

In conclusion, the exia-scenario-generator MCP Server is a powerful tool for automating scenario creation in novel games. Its seamless integration with Claude Desktop and the exia game engine makes it incredibly user-friendly, while its potential for integration with the UBOS platform opens up a world of possibilities for AI-driven content creation and personalized learning experiences.