Webcomic MCP Ecosystem

Visual Novel MCP Server

An MCP server for building a visual novel in Ren'Py, complete with branching routes.

MCP Server Python Ren'Py Visual Novel WIP MIT Built with Claude
The Product

A Visual Novel

Putting together everything from the various MCP servers and skills in my MCP ecosystem so far, including characters and art from the Character and Panel MCP server, backgrounds from the webcomic background generator MCP server, the theme song by the Music Generator MCP server, and assembling the video above with the Anime Production MCP server and skill.

The visual novel MCP server takes the combination of generated assets and the script I penned and weaves them into an actual visual novel. Choices, CG events, even a cover menu.

Showcase

A Mage Transmigrated into a Murim World

Having been isekaied into a medieval fantasy world, Tanaka Makoto masters a spatial-dimensional spell in an attempt to return home. Instead, he finds himself transported to a murim world, where he somehow becomes the fourth direct disciple of the Heavenly Demon. Now, trapped in the dog-eat-dog world of the Jianghu, with his spatial spell no longer effective, Makoto — having taken the name Jeon Jung Seong to blend in — must find a way to survive in the Heavenly Demon Divine Cult.

Not only does he have to outwit the schemes of his rival direct disciples, he needs to navigate through the provinces belonging to the orthodox factions of the Murim Alliance. For if they discover his true identity, they will do everything within their power to eliminate him.

In Progress

  • August 29th 2026 Prologue completed, main theme added, Act 1 in progress.
  • September 7th 2026 Act 1 completed, battle theme BGM added.

Prologue

Complete

Act 1: Disciples of the Heavenly Demon

Complete

Act 2: Dragon-Phoenix Tournament

In Progress
Placeholder — screenshots for Act 2 are not available yet
How It Works

Assembling a Visual Novel

I have been experimenting with my MCP servers to create webcomic and animation prototypes, as you've seen in my other pages. Characters, including character concept sheets, backgrounds and a World Bible, and even theme songs for animated short videos, which include effects.

Then I had a thought. Aren't all these usable assets for assembling a visual novel?

Thus, this MCP server was born.

But why build an MCP server?

Honestly, anyone using Claude Code, whether Opus 5 or Fable 5, can build a visual novel. All you need to do is Ren'Py. However, building it is the easy part. A visual novel isn't simply coding and using Ren'Py. To maintain consistency, you need to generate and register sprites for your characters and keep track of the various routes.

A visual novel is like a graph. I need to build and keep track of menus, choices (which determines the route, so affection values, for example, or what scene happens after you select a specific martial arts manual). I also need to register backgrounds — where the Heavenly Demon Divine Cult's city is, the manors the characters live in, the throne room where the Heavenly Demon constantly resides in, the orthodox factions' cities, etc.

I also needed to create selection cards, to signify a branching point. For example, choosing one of three techniques should feel meaningful and impactful, and I wanted a better UI to reflect that. Hence I turned that into cards. I even added a simple combat mechanic, similar to Pokemon, because I thought it would make the visual novel more interactive. It also makes your choices more meaningful — the techniques you choose to learn are the ones you actually get to use in actual combat. Of course, this also means an entire list of skills and attacks I have to keep track of, each categorized based on the options I offer the player. You're not going to unlock everything — that defeats the purpose of having options. I want the player to feel that they are actively choosing their path: Orthodox, Unorthodox (Magic) and Demonic. This means three separate tracks.

That's where an MCP server comes in. It registers the characters and backgrounds, keeps track of choices and routes, ensures narrative and choice consistency, and even provides a prototype build for me to play through and test. Basically, just like any Model Context Protocol server, it provides context. Currently, my MCP server has 16 tools to help any aspiring visual novel creator assemble their own game.

Is everything generated by AI?

For now, almost everything — from CG to characters to background to music to code — is generated by Claude Code. The story, however, is not.

I write the script, feed it to Claude Code, and have him wire it into the visual novel. He builds a new version of the visual novel, I test it out and check for any discrepancies, and ask him to make changes wherever necessary.

I am also in charge of developing the three different routes (one for each heroine), and I've based them on alignment. The techniques you choose to learn along the story will influence which route you'll end up in, and will show noticeable effects on the narrative. The following training scene will reflect the technique you selected, rather than be a generic description. And yes, I write all of that manually, because the story is mine and mine alone.

Ecosystem workflow

As I mentioned earlier, I realized I already have all the assets required to assemble a visual novel. Backgrounds from the background generator, characters from the character and panel generator, the theme from the music generator. I can even use the animated effects from Anime Production to simulate fight scenes, much like how Fate/Stay Night does it, with flashes, slashes and even ice effects. The visual novel MCP server adds to that process, first by matte-ing a character, allowing them to be sprites that are ready to be dropped on top of a background.

When creating the visual novel, I discovered that I have to create two variants of the same background. Originally, I only generated the day version, but when I wrote my story, many of the scenes take place at night — something Claude Code flagged. Initially, I thought it would be fine to just drop a dark tint on a day background, but as I played through the prototype, it felt inauthentic and I could still see the bright blue day sky. In the end, I bit the bullet and generated night versions, and it looks and plays better now.

The cover art for A Mage Transmigrated into a Murim World — Tanaka Makoto holding an ice spell beside three women in red and white robes, against a snowy mountain
Ecosystem

The latest member of my MCP ecosystem

This is the newest server in a wider ecosystem of my self-built webcomic toolkit. The Background Generator generates backgrounds, the Character and Panel Generator generates consistent characters and panels, Novel Translation translates stories into other languages (and I plan to create Japanese and Korean versions of my visual novel later), Music Generator generates theme songs and background music, and Anime Production provides visual effects and animated videos. I have a speech bubble server planned eventually, but I don't know when that will come.

For everyone's use

Get the server

It's open source (MIT), like the rest of the toolkit. Ask your AI harness to clone the webcomic-toolkit repository and follow the setup docs in visual-novel-mcp.

This is the cheapest server in the ecosystem to run — no model, no weights, no GPU. It parses scripts and keeps a manifest, so it works on any machine. Your AI harness installs Ren'Py itself as part of setup, including the extra component the browser preview needs, so there's nothing for you to download and no account to make. Bring the other servers when you want art and music; this one assembles what they produce.

View the code on GitHub →