mc-rp-assistant

mc-rp-assistant-mcp

Minecraft のリソースパックの分析、検証、管理を行う MCP サーバーです。pack.mcmeta の読み取り、構造の検証、アセットの一覧表示、パックの比較、Modrinth への問い合わせができます。

ツール

ツール	説明
read_packmeta	リソースパックのディレクトリまたは .zip ファイルから pack.mcmeta を読み取ります
validate_rp_structure	リソースパックの構造を検証し、問題（ファイルの不足、形式の不一致、大きすぎるアイコンなど）を報告します
list_rp_assets	パック内のすべてのアセットパス（テクスチャ／モデル／サウンド／言語ファイル）を一覧表示します。ディレクトリと .zip ファイルの両方に対応しています
compare_rpacks	2 つのリソースパックを比較し、追加、削除、変更されたアセットファイルを報告します
search_rp_on_modrinth	Modrinth で名前またはタグを指定してリソースパックを検索します。最大 limit 件の結果を返します
get_rp_info	スラッグまたはプロジェクト ID を指定して、Modrinth のリソースパックの詳細情報を取得します
validate_textures	テクスチャのサイズ上限（>2MB）、命名規則（小文字、スペースなし）、パックアイコンのサイズを検証します
analyze_lang_files	言語ファイル（.lang）を分析し、言語間の翻訳漏れを検出します
compare_rpacks_diff	2 つのリソースパックを比較し、追加／削除／変更されたアセットについて、ファイルサイズを含むファイルごとの詳細情報を返します

エクスポートされる関数

• readPackMetaExport(packPath) — pack.mcmeta を読み取ります
• validateRpStructureExport(packPath, mcVersion?) — パックの構造を検証します
• listRpAssetsExport(packPath, limit?) — アセットファイルを一覧表示します
• compareRpacksExport(oldPackPath, newPackPath) — 2 つのパックを比較します
• searchRpOnModrinthExport(query, limit?) — Modrinth を検索します
• getRpInfoExport(slugOrId) — Modrinth からパック情報を取得します
• validateTexturesExport(packPath) — テクスチャを検証します
• analyzeLangFilesExport(packPath) — 言語ファイルを分析します
• compareRpacksDiffExport(oldPackPath, newPackPath) — パックを詳細に比較します

MCP クライアントの設定

MCP クライアントの設定（例：Trae の settings.json または MCP CLI の設定）に追加します：

{
  "mcpServers": {
    "mc-rp-assistant": {
      "command": "node",
      "args": ["${workspaceFolder}/dist/index.js"]
    }
  }
}

パスに関する注意： ${workspaceFolder} は Trae／VS Code ではプロジェクトのルートを指します。別のエディターを使用する場合は、絶対パスに置き換えてください。例：["C:/Users/xxx/Desktop/mc-rp-assistant-mcp/dist/index.js"]。

設定

このツールは設定なしですぐに使用できます（デフォルト値が組み込まれており、どの環境でもすぐに使えます）。以下の項目は、環境変数またはプロジェクトのルートディレクトリにある .env ファイルで上書きできます（.env.example を .env にコピーしてください）：

変数	デフォルト値	説明
RP_ASSISTANT_MODRINTH_API_BASE	https://api.modrinth.com/v2	Modrinth API のルート URL。自前のゲートウェイ／プロキシに対応しています
RP_ASSISTANT_USER_AGENT	mc-rp-assistant-mcp/1.0	リクエストの User-Agent（Modrinth は出典の明記を求めています）
RP_ASSISTANT_TEXTURE_MAX_MB	2	テクスチャ 1 枚あたりのサイズ上限（MB）。超過すると大きすぎるテクスチャとしてマークされます
RP_ASSISTANT_PACK_ICON_MAX_KB	50	リソースパックのアイコン pack.png のサイズ上限（KB）
RP_ASSISTANT_DEFAULT_SEARCH_LIMIT	10	Modrinth でリソースパックを検索する際のデフォルトの返却件数
RP_ASSISTANT_MAX_SEARCH_RESULTS	50	Modrinth の検索結果の最大件数

優先順位：環境変数 > .env ファイル > rp-config.json > 組み込みのデフォルト値。変更を反映するには、MCP サーバーを再起動してください。

デフォルト設定の拡張：src/rp-config.json（ビルド後は dist/rp-config.json）を編集すると、検索上限、pack.png のサイズしきい値、MC バージョンから pack_format へのマッピングを変更できます。コードの変更は不要です。

必要条件

• Node.js 18+
• @modelcontextprotocol/sdk、zod、adm-zip
• .zip／.mcpkg 形式のリソースパックをサポートするには adm-zip が必要です。依存関係に含まれています

開発

npm run build   # Compile TypeScript
npm run test:unit  # Run unit tests
npm test        # Run all tests

テスト

npm run build
npm test

すべてのユニットテストはオフラインで実行できます。ただし、searchRpOnModrinth と getRpInfo は例外で、ネットワークに接続できない場合はエラーにならず、空の結果を返します。

プラットフォームの互換性

ツール	Windows	macOS	Linux
read_packmeta	✅	✅	✅
validate_rp_structure	✅	✅	✅
list_rp_assets	✅	✅	✅
compare_rpacks	✅	✅	✅
search_rp_on_modrinth	✅	✅	✅
get_rp_info	✅	✅	✅
validate_textures	✅	✅	✅
analyze_lang_files	✅	✅	✅
compare_rpacks_diff	✅	✅	✅

すべてのツールで、クロスプラットフォーム対応の Node.js fs および path API を使用しています。.zip のサポートには adm-zip が必要です。ネットワーク依存のツール（search_rp_on_modrinth、get_rp_info）は、オンラインであればすべてのプラットフォームで動作し、オフラインの場合は問題なく空の結果を返します。

要件

• Node.js 18+
• @modelcontextprotocol/sdk、zod、adm-zip

ライセンス

MIT