FR

fracturedring/renpy-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

21 stars 2 forks 质量 68 趋势 10AGPL-3.0

AI友好视觉小说工具包:基于浏览器的任'Py编辑器和一个包含74个工具的MCP服务器。通过点击、代码或与Claude代码/光标/hermes-agent对话来构建视觉小说。

概览

任'Py是运行视觉小说如《Doki Doki Literature Club》和《杀戮公主》的引擎。它是免费且开源的,但如果你从未写过代码,它的脚本语言会让人望而生畏。这个项目存在的目的就是让你不必自己写代码。 1. 基于浏览器的图形界面,包含故事地图、选择视图、场景检查器和界面、关卡和菜单的视觉作曲器。点击;编辑对话;在任'Py中预览游戏。没有AI,没有命令行。2. 在一个窗口运行编辑器,在另一个窗口运行AI助手(Claude Code、光标、Hermes-agent),两者都指向同一个项目。告诉AI你想要哪个场景;随着图形界面编辑的同步,观察它更新。3. 跳过图形界面;让AI在终端里完成所有操作。从“我有个视觉小说的想法”到“有个可运行的游戏可以玩”最快的路径。 如果选项2或3听起来陌生,可以看 QUICKSTART.md——它能在大约15分钟内从“我从未用过这些”到“我可以预览自己的视觉小说”。

概述(AI 翻译)

制作视觉小说的工具包——手工制作,基于浏览器 编辑,或者借助AI助手的帮助。

任’派是运行视觉小说的引擎 比如《Doki Doki 文学社》和《杀公主》。免费的 而且是开源的,但如果你有过,它的脚本语言会让人望而生畏 从未写过代码。这个项目存在的目的是让你不必写。

你可以用它三种方式:

  1. 仅编辑器。 基于浏览器的图形界面,带有故事地图,选择 画面、场景检查器和视觉作曲家,用于屏幕、舞台, 以及菜单。点击四处;编辑对话;预览游戏 任’Py。没有AI,没有命令行。
  2. 编辑器+AI助手。 在一个窗口中运行编辑器,运行 另一个AI助手(克劳德代码、光标、赫尔墨斯代理), 两者都指向同一个项目。告诉AI你想要哪个场景; 请观看GUI更新,编辑过程。
  3. **纯AI助手。跳过图形界面;让AI自己处理所有事情 终端。从“我有个视觉想法”最快的路径 新颖“到”我可以玩一个可运行的游戏。”

如果选项2或3听起来陌生,请参见 QUICKSTART.md—— 它从“我从未用过这些”到“我可以预览我的 大约15分钟内就拥有视觉小说“。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

renpy-mcp

A toolkit for making visual novels — by hand, with a browser-based editor, or with help from an AI assistant.

Ren’Py is the engine that runs visual novels like Doki Doki Literature Club and Slay the Princess. It’s free and open source, but its scripting language is intimidating if you’ve never written code. This project exists so you don’t have to.

There are three ways you can use it:

  1. Just the editor. A browser-based GUI with a Story Map, Choice View, Scene Inspector, and visual Composers for screens, stages, and menus. Click around; edit dialogue; preview the game in Ren’Py. No AI, no command line.
  2. The editor + an AI helper. Run the editor in one window, run an AI assistant (Claude Code, Cursor, hermes-agent) in another, both pointed at the same project. Tell the AI what scene you want; watch the GUI update as it edits.
  3. Pure AI assistant. Skip the GUI; let the AI do everything in the terminal. Fastest path from “I have an idea for a visual novel” to “there’s a runnable game I can play.”

If options 2 or 3 sound foreign, see QUICKSTART.md — it walks through “I’ve never used any of this” to “I can preview my own VN” in about 15 minutes.

For the under-the-hood story (80 MCP tools, four tiers, a single guarded write pipeline that keeps every edit lint-clean), keep reading.

What it looks like

Story Map — every label in your project as a draggable card. Kind badges (start / scene / choice / ending), drag-to-connect ports for new edges, persisted positions. Built on native pointer events; no React-Flow.

Scene Inspector — opens when you click any node. Renders the label’s ordered event stream (scene, play, show, say, pause, set, jump, …) as typed cards, each with the source line number. The forms at the top edit background / music / dialogue; the Insert event button at the bottom drops in pause / setvar / show / with / flash events.

Choice View — derived player perspective. Every top-level menu: becomes a card listing its choices as pills with if-guard badges. Click a target to jump back to its label in the Story Map.

Library — one tabbed surface for the project’s reusable pieces: Characters (cast cards with display name + accent colour), Assets (backgrounds, sprites, audio), Variables (default values), Screens (screen blocks + imagemaps), and Mini-Games (screen scaffolds). Each tab edits via the matching Tier 3 tool; agents call the same tools directly.

Localization — per-language translation coverage from game/tl//. Click a row to load its stale-string list; the “+ Scaffold” button runs renpy.sh translate to bootstrap a new language.

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "renpy": { "type": "stdio", "command": "/path/to/renpy-mcp/.venv/bin/python", "args": [ "-m", "renpy_mcp", "--sdk", "/path/to/renpy-sdk" ] } } }