mc-rp-assistant-mcp

MCP server for Minecraft resource pack analysis, validation, and management. Reads pack.mcmeta, validates structure, lists assets, compares packs, and queries Modrinth.

Tools

Related MCP server: Packwright MCP

Exported Functions

• readPackMetaExport(packPath) — Read pack.mcmeta

• validateRpStructureExport(packPath, mcVersion?) — Validate pack structure

• listRpAssetsExport(packPath, limit?) — List asset files

• compareRpacksExport(oldPackPath, newPackPath) — Compare two packs

• searchRpOnModrinthExport(query, limit?) — Search Modrinth

• getRpInfoExport(slugOrId) — Get pack info from Modrinth

• validateTexturesExport(packPath) — Validate textures

• analyzeLangFilesExport(packPath) — Analyze language files

• compareRpacksDiffExport(oldPackPath, newPackPath) — Detailed pack comparison

Usage

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

Development

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

Testing

npm run build
npm test

All unit tests are offline except searchRpOnModrinth and getRpInfo which gracefully return empty results when no network is available.

Platform Compatibility

All tools use cross-platform Node.js fs and path APIs. .zip support requires adm-zip. Network-dependent tools (search_rp_on_modrinth, get_rp_info) work on all platforms when online; they return empty results gracefully when offline.

Requirements

• Node.js 18+

• @modelcontextprotocol/sdk, zod, adm-zip

License

MIT