mc-pack-builder-mcp

MCP-сервер для сборки модпаков Minecraft. Создаёт структуру пака, ищет моды на Modrinth, разрешает зависимости и проверяет совместимость.

Инструменты

Related MCP server: HMCL MCP Server

Возможности

• Создание структуры пака — генерирует стандартный каталог модпака со всеми необходимыми файлами

• Интеграция с Modrinth — поиск и запрос метаданных модов напрямую через API Modrinth

• Разрешение зависимостей — прослеживает полное дерево зависимостей, чтобы гарантировать выполнение всех требований

• Проверка совместимости — обнаруживает известные конфликты (например, OptiFine с Fabric, Sodium против Embeddium)

• Работа в офлайне — все локальные инструменты пака работают без сети; только инструменты поиска/информации требуют Modrinth

Установка

Предварительные требования

• Node.js 18+

• npm

Сборка

cd mc-pack-builder-mcp
npm install
npm run build

Запуск как автономного MCP-сервера

node dist/index.js

Сервер обменивается данными через stdio (JSON-RPC 2.0). Его может использовать любой MCP-совместимый клиент.

Настройка для MCP-клиентов

Добавьте в конфигурацию вашего MCP-клиента:

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

Примеры использования

Создать новый модпак

{
  "name": "create_pack",
  "arguments": {
    "pack_dir": "/path/to/MyModpack",
    "name": "My Modpack",
    "mc_version": "1.20.1",
    "loader": "fabric"
  }
}

Найти мод на Modrinth

{
  "name": "search_mods",
  "arguments": {
    "query": "sodium",
    "limit": 5
  }
}

Разрешить зависимости

{
  "name": "resolve_dependencies",
  "arguments": {
    "project_id": "geckolib"
  }
}

Проверить совместимость пака

{
  "name": "check_pack_compatibility",
  "arguments": {
    "pack_dir": "/path/to/MyModpack",
    "mc_version": "1.20.1"
  }
}

Архитектура

mc-pack-builder-mcp/
├── src/
│   └── index.ts        # MCP server + all tool implementations
├── dist/               # Compiled JavaScript (output of tsc)
├── __tests__/
│   └── unit.test.ts    # Unit tests (offline)
├── package.json        # Node.js dependencies (@modelcontextprotocol/sdk, zod)
├── tsconfig.json       # TypeScript config (CommonJS output)
├── test.js             # Integration test runner
├── test_logs/          # Test output logs (gitignored)
└── .gitignore

MCP использует официальный @modelcontextprotocol/sdk v1.x с McpServer и StdioServerTransport.

Тестирование

npm run build
node test.js

Тесты создают временные каталоги в os.tmpdir() и очищают их после себя. Установка Minecraft не требуется.

Совместимость с платформами

Все инструменты используют кроссплатформенные Node.js API fs и path. Инструменты, зависящие от сети (search_mods, get_mod_info, resolve_dependencies), требуют доступа в интернет независимо от платформы.

Лицензия

MIT