renpy-mcp

편집 어시스턴트(Claude Code, Corsor, Copilot, Codex, Zed과 MCP를 지직하는 모듣 도구)가 renpy.sh 호출을 추측하는 데신 Ren'Py SDK의 명령줄을 통해 Ren'Py 프레젝트에서 작어할 수 있게 해주는 MCP 서버입니다.

모든 도구는 SDK에 이미 있명령을 가يب게 감율은 레퍼입니다. 기계 엔진을 재구현하지 않습니다.

배경: renpy/renpy#7313.

Tools 도구

Related MCP server: Godot MCP

설정

Ren'PySDK (8.x)를 all somewhere unpacked and Python 3.10+ are necessary.

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

SDK는 --sdk, 그 다음 RENV_SDK 환경 변수, 그 다음 일반적인 위치(홈 디렉터, Downloads, /opt, /Applications, C:\)에서 검사하여 찾습니다. --checkvit가 잘못된 것을 einler 있那么 ENV_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"]
    }
  }
}

Checkout에서

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

Notes

• project로 지정된 경로는절 기본 디렉토리(game 폴더거가 포함된 디렉토리)입니다. game 자체를 지정해도 작동합니다.

• renpy_run_tests와 게임을 시작하는 모드모든 항목은 디스레이가 필요합니다. 그 외의 명령들은 dummy 비디오/오디오 드버이버로 실행되며, 해당 명령에 대해서는 SDK가 스스로 처리합니다.

• 출력은 필드당 2,00자자로 제한됩니다. 오류가 주로 끝부분에 있으므로 앞이 아닌 미막 팀부분이 버벼됩니다.

• SDK의 CLI는 안정된 인터페이스가 아님으며, 이 MCP 서터도 마참가지입니다. 도구는 최신 버전의 CLI 문서를 기준으로 합니다.

License

MIT.