minecraft-mod-mcp-server

Cloudflare Workers MCP-сервер для разработки модпаков Minecraft. Генерирует главы и задания FTB Quests, скрипты KubeJS (оружие, броня, рецепты), проверяет SNBT/конфигурационные файлы и предоставляет диагностические проверки.

Развертывание

Этот MCP работает на Cloudflare Workers. После развертывания он доступен по адресу:

https://<your-worker>.<your-subdomain>.workers.dev/mcp

Для локальной разработки используется wrangler dev для предварительного просмотра перед развертыванием.

Инструменты

Генерация FTB Quests

Генерация скриптов KubeJS

Проверка и диагностика

Возможности

• Генерация FTB Quests — полный вывод SNBT для книг заданий с зависимостями, наградами и группировкой

• Генерация скриптов KubeJS — оружие, броня, форменные/бесформенные рецепты, плавка и удаление рецептов

• Проверка SNBT — выявляет синтаксические ошибки до того, как они вызовут проблемы во время игры

• Диагностика KubeJS — обнаруживает устаревшие API и проблемы совместимости с движком Rhino

• Ноль сетевых зависимостей — вся генерация чисто алгоритмическая; внешние API не вызываются

• Развертывание на Cloudflare Workers — работает по всему миру с низкой задержкой через пограничную сеть Workers

Установка (локальная разработка)

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

• Node.js 18+

• npm

• Wrangler CLI

Настройка

cd minecraft-mcp-server
npm install

Запуск локально

npm start
# or
npx wrangler dev

Затем подключитесь через MCP-клиент к http://localhost:8788/mcp.

Развертывание на Cloudflare

npm run deploy

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

После развертывания добавьте в конфигурацию вашего MCP-клиента:

{
  "mcpServers": {
    "minecraft-mod": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-stdio"],
      "env": {
        "MCP_SERVER_URL": "https://<your-worker>.<your-subdomain>.workers.dev/mcp"
      }
    }
  }
}

Или, если вы используете MCP-клиент на основе HTTP:

{
  "mcpServers": {
    "minecraft-mod": {
      "url": "https://<your-worker>.<your-subdomain>.workers.dev/mcp"
    }
  }
}

Замените <your-worker> и <your-subdomain> на фактический URL вашего развертывания Cloudflare Workers.

Архитектура

minecraft-mcp-server/
├── src/
│   ├── index.ts           # Cloudflare Worker entry point + MCP server setup
│   ├── types.ts           # Cloudflare Workers environment types
│   ├── tools/
│   │   ├── quest.ts       # FTB Quests generation logic
│   │   ├── kubejs.ts      # KubeJS script generation logic
│   │   └── validate.ts    # SNBT validation + KubeJS diagnostics
│   └── templates/
│       ├── quest_chapter.ts
│       ├── kubejs_item.ts
│       └── kubejs_recipe.ts
├── __tests__/
│   └── unit.test.ts       # Unit tests (fully offline, 49 tests)
├── vitest.config.ts       # Vitest config (ESM, globals: false)
├── package.json           # Dependencies (@modelcontextprotocol/sdk, agents, zod, wrangler)
└── wrangler.jsonc         # Cloudflare Workers deployment config

MCP-сервер построен на @modelcontextprotocol/sdk v1.x и развертывается как Cloudflare Worker с использованием createLegacyMcpHandler из библиотеки agents.

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

npm test
# or
npx vitest run

Все 49 модульных тестов работают полностью офлайн — для тестирования не требуется сеть или учетная запись Cloudflare.

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

Этот MCP полностью работает на инфраструктуре Cloudflare Workers. Единственная зависимость от платформы — наличие учетной записи Cloudflare с включенным Workers. Вся логика генерации написана на чистом JavaScript/TypeScript и полностью кроссплатформенна.

Лицензия

MIT