mc-mod-mcp

Minecraft 모드를 작성할 때 Claude에게 근거 있는 답변을 제공하는 MCP 서버입니다.

이 서버는 현재 실제로 활발히 사용되는 두 가지 모딩 시대인 1.8.9(Forge/MCP, Java 8, Hypixel 스타일 클라이언트 모드)와 1.21.10+(NeoForge 또는 Fabric, Java 21, Mojang 매핑, 데이터 컴포넌트)를 대상으로 합니다. 1.21.x 버전의 경우, linkie를 통한 실시간 매핑 조회는 물론, linkie에 최신 릴리스가 반영되지 않았을 때 piston-meta에서 직접 매핑을 가져올 수도 있습니다.

이 도구가 없으면 Claude는 두 시대를 혼동하여 new ResourceLocation(...)(1.20.5부터 삭제됨)을 환각으로 생성하거나, 아이템이 NBT 대신 데이터 컴포넌트를 사용한다는 사실을 잊거나, 새로운 sequence/yaw/pitch 필드 없이 ServerboundUseItemPacket을 작성하곤 합니다. 이 도구를 사용하면 모델이 추측하는 대신 참조할 수 있는 사실 정보를 얻게 됩니다.

설치

git clone https://github.com/ratph6/mc-mod-mcp
cd mc-mod-mcp
npm install
npm run build

그런 다음 Claude Code가 빌드된 바이너리를 가리키도록 설정하세요:

claude mcp add mc-mod node "$PWD/dist/index.js"

(또는 원한다면 ~/.claude/config.json을 직접 편집하세요).

사용법

평범한 영어로 질문하세요. Claude가 도구를 선택합니다. 실제로 이 도구를 활용하는 몇 가지 예시입니다:

How do I send a useItem packet in 1.21.10 Fabric?

Translate this 1.8.9 snippet to 1.21+: Minecraft.getMinecraft().thePlayer.addChatMessage(new ChatComponentText("hi"))

Scaffold a NeoForge 1.21.10 mod main class for examplemod

Show me a @ModifyVariable mixin example

What's the Yarn name for LocalPlayer in 1.21.10?

도구

처음 12개는 큐레이팅된 도구로, 빠르고 결정론적이며 네트워크를 사용하지 않습니다. 마지막 4개는 필요에 따라 네트워크를 사용합니다.

확장

지식은 src/knowledge.ts에 평면 데이터로 저장되어 있습니다. CLASSES / METHODS / EVENTS / MIXIN_PATTERNS / GOTCHAS / YARN_TO_MOJANG / GRADLE_TEMPLATES에 항목을 추가하고 npm test를 실행하면 완료됩니다. 스캐폴드는 같은 파일 내의 템플릿 함수이며 SCAFFOLD_KINDS를 통해 나열됩니다.

src/
  index.ts          MCP server, tool definitions, stdio transport
  knowledge.ts      Curated data + scaffold templates
  linkie.ts         Live calls to linkie's mappings API
  mojang.ts         Live piston-meta + proguard parser
  smoke.test.ts     node:test smoke tests

주의사항

이 도구는 Mojang/Yarn/Parchment 매핑 파일(수 MB 크기)을 포함하지 않습니다. 원시 난독화 이름을 사용하려면 실시간 도구 또는 linkie를 사용하세요. 이 도구는 작성한 코드가 컴파일되는지 여부는 알려주지 않으며, 해당 시대에 맞는 API 형태인지 여부만 알려줍니다. 번역은 1.8.9와 1.21.10을 대상으로 하며, 중간 버전도 일반적으로 적용되지만 근사치로 간주하세요.