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) — 比较两个资源包

• 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