mc-rp-assistant-mcp

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

ツール

Related MCP server: Packwright MCP

エクスポートされた関数

• 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) — 詳細なパック比較を行います

使用方法

{
  "mcpServers": {
    "mc-rp-assistant-mcp": {
      "command": "node",
      "args": ["<path/to/mc-rp-assistant-mcp>/dist/index.js"]
    }
  }
}

開発

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

テスト

npm run build
npm test

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

プラットフォーム互換性

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

要件

• Node.js 18+

• @modelcontextprotocol/sdk、zod、adm-zip

ライセンス

MIT