Skip to main content
Glama

renpy-mcp

一个 MCP 服务器,可让编辑器助手(Claude Code、Cursor、Copilot、Codex、Zed 以及任何支持 MCP 的工具)通过 Ren'Py SDK 的命令行来处理 Ren'Py 项目,而不是去猜测 renpy.sh 的调用方式。

每个工具都只是 SDK 已有命令的一层薄封装。这里没有重新实现引擎。

Background: renpy/renpy#7313

Tools

工具

运行内容

返回结果

renpy_lint

lint

问题以 {file, line, message} 的形式给出,包括提示、统计信息。支持 lint --format json 的 SDK 上使用该功能(#7314);旧版则解析文本报告,所以返回的格式是一样的。

renpy_project_info

quit --json-dump

标签(labels)、屏幕(screens)、变换(transforms)和 define 变量,以及对应的文件和行号;名称、版本、分辨率;SDK 导出标签流程图时给出的标签流程流转图(#7318)。

renpy_flow

quit --json-dump

单标签的流程:跳转(jumps)、调用(calls)、菜单(menus)及菜单选项、贯穿(fall-through),以及哪些标签可以到达该标签。

renpy_compile

compile

解析错误,以 {file, line, message} 形式返回。

renpy_run_tests

test [filters]

通过/失败状态、[rpytest] 摘要、失败信息、输出尾部。会打开一个窗口。

renpy_last_traceback

读取文件

从项目中读取 traceback.txterrors.txtlog.txt

renpy_run_command

任意命令

运行任意 CLI 命令(translate frenchadd_ids --dry-rundialogue、……)并返回其输出。

renpy_version

--version

当前正在使用哪个 SDK。

Related MCP server: Godot MCP

安装

你需要一个 Ren'Py SDK(8.x)解压在某处,以及 Python 3.10+。

uv tool install renpy-mcp        # or: pipx install renpy-mcp
renpy-mcp --check                # confirms which SDK it found

SDK 的查找顺序是:--sdk 参数,然后是 RENPY_SDK 环境变量,最后是常见位置的搜索(你的主目录、Downloads、/opt/ApplicationsC:\)。如果 --check 找到了错误的 SDK,请设置 RENPY_SDK

Claude Code

claude mcp add renpy -- renpy-mcp --sdk /path/to/renpy-8.5.3-sdk

Cursor / VS Code / 其他

添加一条 stdio 服务条目:

{
  "mcpServers": {
    "renpy": {
      "command": "renpy-mcp",
      "args": ["--sdk", "/path/to/renpy-8.5.3-sdk"]
    }
  }
}

从源码检出运行

uv run renpy-mcp --sdk /path/to/sdk --check
uv run pytest                                     # parser tests
RENPY_SDK=/path/to/sdk uv run pytest              # plus the tests that drive the real SDK

说明

  • 传给 project 的路径是项目的基础目录(包含 game 的那个目录)。直接指向 game 目录也可以。

  • renpy_run_tests 以及任何需要启动游戏的操作都需要显示环境。其它命令会在虚拟的视频和音频驱动下运行,SDK 会自动处理这些命令。

  • 每个字段的输出上限为 20,000 个字符;超出时会丢弃开头而不是结尾的部分,因为错误通常出现在输出末尾。

  • SDK 的 CLI 并不是稳定接口,这些工具也不是。工具会跟踪当前版本的 CLI 文档。

许可证

MIT。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables comprehensive management of TyranoStudio visual novel projects including project creation, scenario editing with syntax validation, resource management, and TyranoScript development assistance. Supports project analysis, template generation, and Git integration for visual novel game development.
    2
    -
  • A
    license
    A
    quality
    F
    maintenance
    Enables AI assistants to interact with the Godot game engine by launching the editor, running projects, capturing debug output, managing scenes and nodes, and controlling project execution through a standardized interface.
    18
    147
    11
    MIT
  • A
    license
    B
    quality
    Not graded
    maintenance
    Enables AI assistants to interact with the Godot game engine by launching the editor, running projects, capturing debug output, managing scenes and nodes, and controlling project execution through a standardized interface.
    14
    147
    1
    -
  • A
    license
    B
    quality
    C
    maintenance
    Enables AI assistants to interact with the Godot game engine, including launching the editor, running projects, capturing debug output, and managing scenes.
    84
    1
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/wgu9/renpy-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server