RimWorld Mod MCP의 개요
GitHub 사용자 mushroomTW의 RimWorld Mod MCP는 코딩 에이전트가 혼자서는 할 수 없는 RimWorld 모드 제작 과정을 Claude Code, Codex 등 MCP 클라이언트에 제공합니다. 게임의 Def XML과 C# 심볼을 색인하고, 게임과 설치된 모드를 필요할 때 디컴파일하며, 구조화된 컴파일러 오류와 함께 모드를 만들고 빌드합니다. 또 RimWorld를 격리된 세션에서 실행하고, 그 오류와 게임 상태를 작은 게임 내 브리지 모드를 통해 에이전트에게 돌려줍니다.
RimWorld 1.7만 지원하며 Windows, macOS, Linux용 단일 자체 포함 실행 파일로 배포됩니다. 저장소는 2026년 9월 26일에 만들어졌고 2026년 10월 25일에 v0.3.1을 출시했으며, 스타 3개, 포크 0개, MIT 라이선스입니다. Steam Workshop에는 절대 게시하지 않으며, 첫 빌드 때 NuGet 참조 패키지 하나를 받는 것 외에는 네트워크 호출을 하지 않습니다.
RimWorld Mod MCP 설치 방법
Download the release executable and register it with the argument stdioRimWorld Mod MCP, 쓸 만한 가치가 있습니까?
게임 모드 제작용 서버 대부분은 검색에서 멈춥니다. 이 서버는 루프를 닫습니다. 에이전트가 Def나 클래스의 동작을 찾아보고, 모드를 쓰고, 빌드하고, 그 모드만 켠 채 게임을 실행해 무엇이 깨졌는지 읽어 올 수 있습니다. 빌드 실패는 MSBuild 원본 출력 대신 오류 코드, 파일, 줄, 열로 돌아오고, 브리지는 맵이 로드되었는지, tick, 일시 정지 여부, 열린 대화 상자를 알려 주어 에이전트가 플레이 가능한 상태를 기다린 뒤 테스트를 판단할 수 있습니다.
색인은 단계별로 합리적으로 나뉘어 있습니다. IL 메타데이터를 직접 읽어 약 10만 개 심볼의 색인을 완전한 상속 체인과 함께 몇 초 만에 만들고, 개별 멤버는 필요할 때 밀리초 단위로 디컴파일하며, 디컴파일한 소스의 전문 검색은 백그라운드에서 몇 분에 걸쳐 채워집니다. find_def_usages는 XML 상호 참조와 C# DefOf 필드를 가로질러 Def를 추적하는데, 번역 파일을 쓰기 전에 모드 제작자에게 필요한 확인이 바로 이것입니다. 다른 모드의 어셈블리도 디컴파일하고 검색할 수 있어 호환 패치 작업에 도움이 됩니다.
격리도 세심합니다. 테스트 세션은 RimWorld를 임시 저장 폴더로 돌리고, 테스트 대상 모드와 그 의존성만 켠 ModsConfig.xml을 생성하며, 작업 폴더를 Mods 폴더에 링크합니다. 게임이 이미 실행 중이면 시작을 거부하고, 끝나면 모드 소스는 건드리지 않고 링크만 제거합니다. 브리지는 세션마다 일회용 토큰을 써서 127.0.0.1의 49460 포트에만 연결합니다. 약점은 쓰기입니다. create_mod, build_mod, run_test_cycle은 허용 목록 없이 어떤 로컬 경로든 받아들이므로 클라이언트의 권한 확인이 유일한 경계입니다.
README는 네 경쟁 프로젝트와 공정하게 비교합니다. Modmixer는 자체 에이전트와 Workshop 게시 기능을 갖춘 데스크톱 앱이고, RimSage와 RiMCP_hybrid는 조사만 하며, RimBridgeServer는 스크린샷과 UI 조작을 포함해 실행 중인 게임을 더 깊이 제어하고 README는 이를 보완 관계라고 봅니다. 진짜 위험은 성숙도입니다. 첫 달에만 8번 릴리스했고 관리자는 한 명이며 커밋 메시지는 주로 번체 중국어이고, RimWorld 1.6은 명시적으로 지원하지 않습니 다. 이미 1.7에서 Claude Code나 Codex를 쓰는 모드 제작자라면 부수 프로젝트로 시험해 볼 만합니다.
제 역할을 하는 곳
작은 콘텐츠 모드를 관리하는 취미 모드 제작자
XML과 C# 모드를 RimWorld 1.7로 이식하기
에이전트가 read_symbol로 바뀐 심볼을 읽고 코드를 고친 뒤 진단이 깨끗해질 때까지 build_mod를 돌리고, 이어서 run_test_cycle을 실행하고 list_test_diagnostics로 오류를 확인하게 합니다. 모델 토큰 외에는 무료이며, 모드는 Git으로 관리합니다.
인기 모드용 호환 패치를 만드는 모드 제작자
Harmony 패치를 추가하기 전에 상대 모드가 어떤 클래스를 패치하는지 찾기
inspect_installed_mod로 상대 모드의 어셈블리를 디컴파일한 뒤 search_source로 패치된 메서드를 찾습니다. 큰 모드는 첫 디컴파일에 몇 분이 걸릴 수 있지만 모드별로 동작해 다른 모드를 막지 않습니다.
기존 모드에 언어를 추가하는 번역가
Languages XML을 쓰기 전에 번역 대상 필드를 모두 확인하기
각 Def에 find_def_usages를 실행해 XML과 C# 참조를 나열한 다음 Languages 파일을 쓰 고 build_mod로 XML을 검증합니다. 게임이 실제로 읽는 라벨을 추측할 필요가 없습니다.
도입 전 확인할 점
- 설정
- 최신 릴리스에서 사용하는 플랫폼의 실행 파일을 내려받고, macOS나 Linux에서는 실행 권한을 준 뒤 MCP 클라이언트에 stdio 인자로 등록합니다. rimworld_status를 호출하고 rebuild_index를 한 번 실행합니다. C# 모드와 브리지를 빌드하려면 .NET SDK 10이 필요합니다.
- 연동
- 조사, 설치된 모드, 빌드, 테스트에 걸친 19개 도구. Claude Code와 Codex용 예제가 있으며 stdio를 지원하는 MCP 클라이언트라면 동작합니다. 모드 프로젝트는 NuGet 패키지 Krafs.Rimworld.Ref로 RimWorld API를 참조합니다.
- 데이터와 개인정보
- 로컬 전용입니다. 게임 파일, 디컴파일 결과, 색인, 진단은 모두 사용자 컴퓨터에 남고, 브리지는 일회용 토큰으로 127.0.0.1에만 연결합니다. 다만 도구가 반환한 내용은 모델 제공업체로 갑니다. 파일을 쓰는 도구에는 경로 허용 목록이 없습니다.
- 제한
- RimWorld 1.7 전용입니다. 소스 전문 검색은 백그라운드 색인이 끝나야 쓸 수 있습니다. 진단과 대략적인 상태 외에 스크린샷이나 게임 내 조작은 없습니다. 게임이 이미 실행 중이면 테스트가 시작되지 않습니다.
좋은 점
- 조사, 빌드, 격리 테스트를 로컬 서버 하나에서
- 약 10만 개 심볼 색인을 몇 초 만에 구축
- 구조화된 컴파일러 진단과 실시간 게임 상태
- 네트워크 호출도 Workshop 게시도 없음
아쉬운 점
- RimWorld 1.7 전용이며 1.6은 지원하지 않음
- 파일을 쓰는 도구에 경로 허용 목록이 없음
- 스타 3개에 관리자는 한 명
- macOS 빌드는 공증되지 않음
추천 대상
이미 Claude Code나 Codex를 쓰면서 에이전트가 자기 변경을 직접 빌드하고 테스트하기를 원하는 RimWorld 1.7 모드 제작자에게 맞습니다.
RimWorld Mod MCP 대안
RimWorld Mod MCP: 자주 묻는 질문
- RimWorld Mod MCP, 쓸 만한 가치가 있습니까?
- 에이전 트가 할 수 없는 조사, 빌드, 테스트 단계를 맡아 주는 RimWorld 1.7용 모드 제작 루프로 설계가 꼼꼼하지만, 나온 지 6주 된 프로젝트라 아직 사용자가 거의 없습니다. 평점은 5점 만점에 3.6점입니다.
- RimWorld Mod MCP의 가격은 얼마입니까?
- 무료 오픈 소스(MIT)입니다. 정식으로 설치한 RimWorld 1.7과, 빌드용으로 무료 .NET SDK 10이 필요합니다.
- RimWorld Mod MCP의 단점은 무엇입니까?
- RimWorld 1.7 전용이며 1.6은 지원하지 않음; 파일을 쓰는 도구에 경로 허용 목록이 없음; 스타 3개에 관리자는 한 명; macOS 빌드는 공증되지 않음.
- RimWorld Mod MCP에 적합한 사람은 누구입니까?
- 이미 Claude Code나 Codex를 쓰면서 에이전트가 자기 변경을 직접 빌드하고 테스트하기를 원하는 RimWorld 1.7 모드 제작자에게 맞습니다.
- RimWorld Mod MCP에 회사 데이터를 맡겨도 안전합니까?
- 로컬 전용입니다. 게임 파일, 디컴파일 결과, 색인, 진단은 모두 사용자 컴퓨터에 남고, 브리지는 일회용 토큰으로 127.0.0.1에만 연결합니다. 다만 도구가 반환한 내용은 모델 제공업체로 갑니다. 파일을 쓰는 도구에는 경로 허용 목록이 없습니다.
- RimWorld Mod MCP의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Godot MCP입니다.
답변 확인일: 2026년 11월 7일.