Geometry Dash MCP Server 🎮

Полнофункциональная AI-система для создания, анализа и визуализации уровней Geometry Dash!

🌟 Особенности

Это революционная система для разработки уровней Geometry Dash с использованием AI:

• 🤖 AI-управляемое создание - создавайте уровни через естественный язык

• 🎨 30+ команд - полный контроль над объектами, триггерами, группами

• 📊 Экспорт в JSON - сохраняйте и анализируйте уровни

• 🖼️ Рендер в PNG - визуализация уровней с сеткой

• 🧠 AI анализ - получайте рекомендации по улучшению дизайна

• ⚡ Real-time - изменения применяются мгновенно через named pipe

• 🔧 Geode мод - нативная интеграция с Geometry Dash

• 📦 PyPI Ready - установка одной командой pip install gdmcp

Related MCP server: Godot MCP Server

🎯 Что можно делать

• ✅ Создавать объекты (блоки, шипы, порталы, орбы)

• ✅ Настраивать триггеры (Move, Rotate, Scale, Alpha, Color, Pulse)

• ✅ Управлять группами и цветами

• ✅ Batch операции (копирование, масштабирование, вращение)

• ✅ Экспортировать уровни в JSON

• ✅ Рендерить визуализацию в PNG

• ✅ Получать AI анализ играбельности и дизайна

• ✅ Итеративно улучшать уровни на основе AI рекомендаций

🚀 Быстрый старт

1. Установка Python MCP сервера

Теперь сервер можно установить одной командой через PyPI:

pip install gdmcp

После установки команда gdmcp станет доступна глобально в вашей системе.

2. Установка Geode мода

1. Скачайте последнюю версию мода из Releases

2. Скопируйте gdmcp.geode в папку с модами Geode:

   • Стандартный путь: %LOCALAPPDATA%\GeometryDash\geode\mods\

   • Или в папку с игрой: <путь к GD>\geode\mods\

3. Запустите Geometry Dash

3. Настройка OpenCode / Claude Desktop / Devin

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

{
  "mcpServers": {
    "gdmcp": {
      "command": "gdmcp"
    }
  }
}

Перезапустите ваш MCP клиент.

4. Создайте первый уровень

Откройте редактор уровня в Geometry Dash, затем в вашем AI клиенте напишите:

Create a playable Geometry Dash level with platforms, spikes, and an orb

🤖 Рекомендуемые AI модели

GDMCP лучше всего работает с продвинутыми языковыми моделями:

• Claude Opus 4.7 - отличные результаты ✅

• Claude Opus 4.6 - отличные результаты ✅

• Claude Sonnet 4.6 - хорошие результаты ✅

• GPT 5.4 - хорошие результаты ✅

• И другие современные модели

Эти модели хорошо понимают контекст создания уровней и дают качественные рекомендации по дизайну.

🎮 Пример профессионального уровня

Автор: Viteral666 (aka Okira)

Этот репозиторий был протестирован на реальном профессиональном уровне:

• 17,969 объектов - 4 года разработки

• 1,434 триггера - сложная анимация и эффекты

• 401 Color Trigger - динамическая цветовая палитра

• 384 Rotate Trigger - вращающиеся элементы

• 189 Shader Trigger - продвинутые визуальные эффекты

Система успешно экспортировала, визуализировала и проанализировала этот уровень!

🛠️ Доступные инструменты

Создание объектов

• gd_create_object - Создать объект с группами и цветами

• gd_create_text - Создать текстовый объект

• gd_create_item_counter - Создать счётчик предметов

• gd_create_collision_block - Создать блок коллизий

• gd_create_teleport_portal - Создать телепорт портал

Базовые триггеры

• gd_move_trigger - Move Trigger (движение объектов)

• gd_alpha_trigger - Alpha Trigger (прозрачность)

• gd_rotate_trigger - Rotate Trigger (вращение)

• gd_scale_trigger - Scale Trigger (масштабирование)

Продвинутые триггеры

• gd_pulse_trigger - Pulse Trigger (пульсация цвета)

• gd_color_trigger - Color Trigger (изменение цвета канала)

• gd_follow_trigger - Follow Trigger (следование за группой)

• gd_spawn_trigger - Spawn Trigger (спавн объектов)

• gd_stop_trigger - Stop Trigger (остановка триггеров)

• gd_toggle_trigger - Toggle Trigger (показать/скрыть группу)

• gd_shake_trigger - Shake Trigger (тряска камеры)

• gd_animate_trigger - Animate Trigger (анимация объектов)

• gd_shader_trigger - Shader Trigger (эффекты Chromatic, Glitch, Blur и др.)

• gd_sfx_trigger - SFX Trigger (воспроизведение звуковых эффектов)

• gd_edit_trigger - Редактирование свойств существующего триггера

Камера и эффекты (2.2)

• gd_zoom_trigger - Управление зумом камеры

• gd_camera_static - Статическая камера (следование за группой)

• gd_create_particle - Создание кастомных систем частиц (ID 1900)

• gd_capture_screenshot - Чистый скриншот редактора без UI

• gd_sync_calculator - Расчёт X-позиций для синхронизации с музыкой (BPM)

• gd_apply_preset - Применение сложных декораций из библиотеки пресетов (deco_library)

Управление объектами

• gd_move_objects - Переместить группу объектов

• gd_copy_objects - Копировать объекты группы

• gd_paste_objects - Вставить скопированные объекты

• gd_rotate_objects - Повернуть группу объектов

• gd_scale_objects - Масштабировать группу объектов

• gd_flip_objects - Отразить группу объектов

• gd_delete_objects - Удалить объекты по группе

• gd_delete_all - Удалить все объекты

Анализ и поиск

• gd_get_level_info - Получить статистику уровня

• gd_get_level_statistics - Детальная статистика уровня

• gd_list_objects - Список первых 50 объектов

• gd_get_objects_by_group - Получить объекты по группе

• gd_get_triggers_by_type - Получить триггеры по типу

• gd_validate_level - Проверить уровень на ошибки

Утилиты

• gd_batch_create - Массовое создание объектов

• gd_pattern_generator - Генератор паттернов (line, circle, grid, wave)

• gd_import_level - Импорт уровня из JSON

• gd_export_level - Экспорт уровня в JSON

• gd_render_level - Рендер уровня в PNG с сеткой

Оптимизация и бэкапы

• gd_optimize_level - Оптимизация уровня (удаление дубликатов, невидимых объектов)

• gd_auto_backup_start - Запустить автоматические бэкапы

• gd_auto_backup_stop - Остановить автоматические бэкапы

Система версий

• gd_save_version - Сохранить текущую версию уровня с комментарием

• gd_list_versions - Показать список всех версий

• gd_restore_version - Восстановить уровень из версии

Совместная работа

• gd_export_section - Экспорт секции уровня (диапазон X)

• gd_import_section - Импорт секции в уровень

• gd_merge_levels - Объединить два уровня (horizontal, vertical, overlay)

Управление

• gd_undo - Отменить последнее действие

• gd_redo - Повторить отменённое действие

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

Создание простого уровня

Create 5 blocks at ground level (Y=105) starting from X=100
Add a spike at X=200, Y=135
Add a yellow orb at X=300, Y=200
Export and render the level

Добавление анимации

Create a platform at X=500, Y=105 in group 1
Add a Move Trigger to move group 1 up by 100 units over 2 seconds
Add a Rotate Trigger to rotate group 1 by 360 degrees

Анализ существующего уровня

Get level info from Geometry Dash
Export the current level to JSON
Render the level to PNG

🔥 AI-управляемая разработка уровней

Эта система демонстрирует будущее разработки игр:

1. Создание через естественный язык - просто опишите что хотите

2. AI анализ - получайте профессиональные рекомендации

3. Итеративное улучшение - улучшайте дизайн на основе AI фидбека

4. Визуализация - видите результат до тестирования в игре

Процесс разработки с AI

1. Создайте базовый уровень
   → "Create a simple platformer level"

2. Экспортируйте и визуализируйте
   → "Export and render the level"

3. Получите AI анализ (через GigaChat MCP)
   → Анализ играбельности, баланса, дизайна

4. Улучшите на основе рекомендаций
   → "Add more platforms to fill the gaps"

5. Повторяйте до достижения 9/10!

📁 Структура проекта

geometry-dash-mcp/
├── geode-mod/              # Geode мод для Geometry Dash
│   ├── src/
│   │   ├── main.cpp        # Основной код мода
│   │   ├── CommandHandlers.hpp  # Обработчики команд
│   │   └── MCPPanel.hpp    # UI панель в игре
│   └── mod.json            # Метаданные мода
├── mcp_server_gd/          # Python MCP сервер
│   ├── __init__.py         # MCP инструменты
│   └── renderer.py         # Рендерер PNG
├── .github/workflows/      # GitHub Actions для сборки
└── README.md               # Эта документация

🔧 Разработка

Сборка Geode мода

Мод собирается автоматически через GitHub Actions при каждом push.

Для локальной сборки:

cd geode-mod
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release

Разработка Python сервера

# Установка в режиме разработки
pip install -e .

# Сборка и загрузка в PyPI
pip install build twine
python -m build
python -m twine upload dist/*

⚠️ Важные замечания

• Требуется Geode - мод работает только с Geode SDK 3.0+

• Только для редактора - не используйте в онлайн режиме

• Резервные копии - регулярно экспортируйте уровни в JSON

• Тестирование - всегда тестируйте уровни перед публикацией

🤝 Вклад в проект

Помогите улучшить проект:

• 🐛 Сообщайте о багах через Issues

• 💡 Предлагайте новые функции

• 📖 Улучшайте документацию

• ⭐ Ставьте звезду если проект полезен!

🎨 Благодарности

Тестирование на профессиональном уровне:

• Viteral666 (aka Okira) - автор тестового уровня (17,969 объектов, 4 года разработки)

Технологии:

• Geode SDK - модификация Geometry Dash

• Model Context Protocol - AI интеграция

• FastMCP - Python MCP framework

• GigaChat - AI анализ уровней

📄 Лицензия

MIT License - используйте свободно!

🔗 Ресурсы

• Geode SDK Documentation

• MCP Documentation

• Geometry Dash Modding Discord

Создано: 18 апреля 2026
Версия: 2.2.0
Статус: Production Ready ✅

Достижения:

• ✅ Официальный PyPI пакет gdmcp

• ✅ 60+ команд для управления уровнями

• ✅ Полная поддержка Geometry Dash 2.2

• ✅ Библиотека декораций deco_library

• ✅ Auto-backup и Version Control

• ✅ Рендер в PNG и экспорт в JSON

• ✅ Протестировано на уровне с 17,969 объектами