mc-mod-mcp

Minecraft MOD開発時にClaudeへ根拠に基づいた回答を提供するためのMCPサーバーです。

現在も活発なMOD開発シーンの2つの時代、1.8.9 (Forge/MCP, Java 8, HypixelスタイルのクライアントMOD) と 1.21.10+ (NeoForgeまたはFabric, Java 21, Mojangマッピング, Data Components) を対象としています。1.21.x向けには、linkieに対するライブマッピング検索や、linkieが最新リリースを取り込んでいない場合にpiston-metaから直接マッピングを取得する機能も備えています。

これがないと、Claudeは2つの時代を混同し、new ResourceLocation(...) (1.20.5で廃止) を幻視したり、アイテムがNBTではなくData Componentsを使用することを忘れたり、新しい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を対象としています。中間バージョンでも通常は適用可能ですが、あくまで近似値として扱ってください。