mc-rp-assistant-mcp

MCP-сервер для анализа, проверки и управления ресурспаками Minecraft. Читает 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 API fs и path. Поддержка .zip требует adm-zip. Сетевые инструменты (search_rp_on_modrinth, get_rp_info) работают на всех платформах при наличии интернета; при его отсутствии они корректно возвращают пустые результаты.

Требования

• Node.js 18+

• @modelcontextprotocol/sdk, zod, adm-zip

Лицензия

MIT