Geometry Dash MCP Server 🎮

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

<img src="https://raw.githubusercontent.com/NoAme2289-afk/geometry-dash-mcp-geode/main/preview.png" alt="Level Preview" width="600" />

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

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

• 🤖 AI-управляемое создание - создавайте уровни через естественный язык
• 🎨 30+ команд - полный контроль над объектами, триггерами, группами
• 📊 Экспорт в JSON - сохраняйте и анализируйте уровни
• 🖼️ Рендер в PNG - визуализация уровней с сеткой
• 🧠 AI анализ - получайте рекомендации по улучшению дизайна
• ⚡ Real-time - изменения применяются мгновенно через named pipe
• 🔧 Geode мод - нативная интеграция с Geometry Dash
• 📦 PyPI Ready - установка одной командой pip install gdmcp

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

• ✅ Создавать объекты (блоки, шипы, порталы, орбы)
• ✅ Настраивать триггеры (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 объектами