🚩 Flag MCP

✨ Что такое «Flag»?

В визуальных новеллах и галгемах «флаг» (フラグ) — это момент, когда выбор запускает новую сюжетную ветку. Одно решение меняет всё.

Flag MCP привносит ту же силу в программирование с помощью ИИ. Когда ваш ИИ-ассистент оказывается на распутье, он не гадает — он поднимает флаг и ждет, пока вы выберете маршрут.

🎮 Вы — главный герой. ИИ ждет в каждой точке ветвления.

💎 Каждый флаг формирует маршрут. Больше никаких спекулятивных переписываний кода.

🚀 Богатые возможности взаимодействия. Текст, скриншоты, аннотации — весь ваш арсенал.

Это превращает программирование с ИИ из «надеюсь, это сработает» в повествование, где вы держите контроллер в своих руках.

Область применения:

• Планы программирования с оплатой за каждый запрос.

• Разработчики, которые хотят контролировать поведение ИИ.

🔥 До и после

🎯 Основные функции

• 🖥️ Темный интерфейс — элегантное нативное диалоговое окно, которое вписывается в ваш рабочий процесс

• ✅ Выбор маршрута — структурированные предопределенные варианты (в стиле чекбоксов)

• 💬 Свободный текст — когда предопределенных маршрутов недостаточно, напишите свой собственный сценарий

• 📷 Арсенал мультимедиа

  • Вставка изображений из буфера обмена

  • Выбор локальных файлов

  • Скриншот + встроенный аннотатор (прямоугольник, круг, стрелка, перо, текст, обрезка)

• 🖼️ Изображения для подсказок — ИИ может показывать вам изображения (локальные пути, file://, http(s)://)

• 🔒 Безопасность прежде всего — удаленные изображения проверяются, ограничены по размеру, загружаются асинхронно

• 🎨 Оптимизировано для macOS — правильная обработка иконок и визуальная полировка

📦 Установка

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

• Python >= 3.11

• uv (рекомендуется) или pip

Быстрая установка

git clone https://github.com/pauoliva/interactive-feedback-mcp.git
cd interactive-feedback-mcp
uv sync

⚙️ Конфигурация

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

Cursor (mcp.json) / Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "interactive-feedback": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/interactive-feedback-mcp",
        "run",
        "server.py"
      ],
      "timeout": 900000,
      "autoApprove": ["interactive_feedback"]
    }
  }
}

⚠️ Примечание: Тайм-аут указан в миллисекундах для Cursor (900000 = 15 мин). Некоторые клиенты используют секунды — настройте соответствующим образом.

🚩 Инструмент interactive_feedback

Аргументы

Возвращаемые значения

• Текстовая обратная связь от пользователя

• Опциональные вложения изображений (как блоки контента изображений MCP)

🧙 Советы профессионалов

Рекомендуемые правила для агента

Добавьте это в пользовательские инструкции вашего ИИ-ассистента:

If requirements are unclear, call interactive_feedback before implementing.
Present predefined options whenever possible — give the user clear route choices.
Before finishing a task, call interactive_feedback once more for final confirmation.

Переменные окружения

🛡️ Безопасность и надежность

• ✅ Удаленные изображения проверяются по типу контента (image/*)

• ✅ Большие полезные нагрузки отклоняются через ограничение размера

• ✅ Асинхронная загрузка поддерживает отзывчивость интерфейса

• ✅ Локальные файлы считываются только при явном обращении

📄 Лицензия

Лицензия MIT — форкайте, помечайте, выпускайте.

🚩 Установите свой флаг. Напишите свой собственный маршрут.

Сделано с 💜 для разработчиков, которые отказываются быть NPC в своей собственной кодовой базе.