MCP Brainstorm Server

MCP-сервер (Model Context Protocol), который запускает легкий и эффективный локальный UI для интерактивного мозгового штурма, планирования и визуализации с помощью ИИ. Разработан для беспрепятственной работы с Claude и другими ИИ-агентами для совместных рабочих процессов по генерированию идей.

Что он делает

Основной рабочий процесс

1. Обнаружение: Когда вы упоминаете ключевые слова для мозгового штурма (brainstorm, plan, think, how do...), ИИ-агент спрашивает, хотите ли вы использовать интерактивный UI

2. Запуск: Сервер запускается на localhost с URL, специфичным для сессии

3. Взаимодействие: Отрисовка материалов для мозгового штурма с использованием диаграмм mermaid или HTML UI в стиле Tailwind

4. Отправка: Пользователи взаимодействуют с кликабельными кнопками, вводят комментарии и при необходимости загружают/вставляют изображения

5. Получение: ИИ-агент считывает отправленные ответы, чтобы продолжить работу

6. Документирование: Опциональное сохранение в plans/*.md для дальнейшего использования

Related MCP server: tldraw-mcp

Функции

• Поддержка нескольких сессий: Каждая сессия ИИ-агента получает свой собственный URL (localhost:{port}/{sessionid}), а названия вкладок отражают рабочую директорию для легкого различения

• Общая установка для всех агентов: Один локальный клон и одно окружение Python могут использоваться одновременно Claude, Codex и другими MCP-совместимыми агентами, поэтому вы устанавливаете его один раз на машину, а не один раз на агента

• Отрисовка богатого контента:

  • Диаграммы Mermaid для графиков, блок-схем и визуализаций

  • UI в стиле Tailwind CSS для опций и интерфейсов мозгового штурма

  • Рендерер форматов, совместимый с Markdown, со встроенными диаграммами и таблицами

• Интерактивные элементы:

  • Автоматически генерируемые ID для разделов и опций (для легкой ссылки)

  • Кликабельные кнопки для выбора пользователя

  • Поля ввода для встроенных комментариев

  • Рабочий процесс "Отправить/Готово"

• Поддержка изображений:

  • Загрузка локальных файлов через выборщик файлов

  • URL, доступные из интернета

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

• Эффективность ресурсов: Легкий Python-сервер, разработанный для работы одного пользователя

• Только Loopback: HTTP UI жестко ограничен адресами loopback и отклоняет нелокальных клиентов

Архитектура

Компоненты

├── mcp_server.py          # MCP server implementation (Python)
├── server/                # localhost UI server
│   ├── app.py            # Flask/FastAPI server
│   ├── templates/        # HTML templates
│   └── static/           # CSS, JS, assets
└── requirements.txt      # Dependencies

Данные времени выполнения по умолчанию хранятся вне репозитория в ~/.mcp/brainstorm-mcp/:

~/.mcp/brainstorm-mcp/
├── sessions/             # Session state storage
│   └── assets/           # Uploaded or pasted image data
├── plans/                # User-saved markdown plans
└── preferences/          # Brainstorm preferences (instructions to the AI)
    ├── global.json       # Machine-wide defaults
    └── projects/         # Per-project overrides, keyed by hashed absolute path

Настройки для конкретных проектов находятся в центральном корне данных (никогда внутри репозитория проекта), поэтому настройка проекта никогда не добавляет файлы в рабочее дерево этого проекта.

Управление сессиями

• Каждая сессия получает уникальный sessionid (UUID или аналогичный)

• Состояние сессии по умолчанию хранится в легком постоянном хранилище в директории пользователя ~/.mcp/brainstorm-mcp/

• URL: localhost:PORT/{sessionid}

• Названия вкладок отражают рабочую директорию (pwd) терминала ИИ-агента

Технологический стек

• MCP Framework: Python MCP SDK

• Backend: Python (Flask/FastAPI для легкого HTTP-сервера)

• Frontend Rendering:

  • Диаграммы: Mermaid.js

  • UI/Стилизация: Tailwind CSS

  • Markdown: Совместимый формат со встроенной поддержкой Mermaid

• Хранилище: JSON/SQLite (минимальное, для состояния сессии)

Установка и использование

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

• Python 3.9+

• MCP-клиент (Claude или совместимый ИИ-агент)

Полное руководство по установке

Для получения полных инструкций по установке, включая:

• использование существующего локального клона

• клонирование в рекомендуемое общее расположение MCP-сервера

• подключение сервера к Codex

• подключение сервера к Claude Code

• повторное использование одной установки для нескольких агентов

См. INSTALL.md.

Настройка

git clone <repo-url>
cd mcp-brainstorm-server
pip install -r requirements.txt

Запуск сервера

Сервер запускается по требованию инструментом MCP, когда ИИ-агент обнаруживает ключевые слова для мозгового штурма. Пользователи также могут запустить его вручную:

python mcp_server.py

Ожидаемые зависимости

anthropic-mcp
flask  # or fastapi
pydantic
python-dotenv

Поток протокола

Пример: Планирование функции

1. Пользователь: "Давай проведем мозговой штурм по архитектуре для этой функции"

2. ИИ-агент: Обнаруживает ключевое слово → Спрашивает "Открыть интерактивный UI для мозгового штурма?"

3. Пользователь: "Да"

4. Сервер: Запускается на localhost:8080/abc-def-123-ghi (sessionid на основе pwd)

5. UI: Отрисовывает диаграмму mermaid возможных архитектур с кликабельными опциями, полями для комментариев и областью загрузки изображений

6. Пользователь: Нажимает на предпочтительный вариант архитектуры, добавляет комментарии, при необходимости загружает справочную диаграмму

7. Пользователь: Нажимает "Отправить"

8. Сервер: Сохраняет отправленные данные под sessionid

9. Пользователь: Возвращается к ИИ-агенту и говорит "ответ отправлен"

10. ИИ-агент: Получает отправленные данные через MCP → Продолжает планирование с учетом ввода пользователя

11. ИИ-агент (опционально): "Сохранить этот план? Предлагаемое местоположение: plans/feature-architecture.md" Место сохранения по умолчанию на диске: ~/.mcp/brainstorm-mcp/plans/feature-architecture.md

Спецификация инструментов MCP

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

start_brainstorm_session

Запускает сессию интерактивного UI для мозгового штурма.

Ввод:

• prompt (str): Начальный промпт/контекст для мозгового штурма

• content_type (str): "mermaid", "html" или "markdown"

• working_dir (str, опционально): Текущая рабочая директория (используется для названия вкладки)

Вывод:

• session_id (str): Уникальный идентификатор сессии

• url (str): Полный localhost URL для доступа к UI

• port (int): Используемый номер порта

get_session_response

Получает отправленные пользователем данные из завершенной сессии.

Ввод:

• session_id (str): Идентификатор сессии

Вывод:

• response (dict): Выбранные пользователем опции, комментарии и изображения

• timestamp (str): Время отправки

• status (str): "pending", "submitted", "expired"

list_sessions

Перечисляет все активные сессии.

Вывод:

• sessions (list): Массив объектов активных сессий с ID, URL и временем создания

close_session

Завершает и очищает сессию.

Ввод:

• session_id (str): Сессия для закрытия

set_brainstorm_preferences

Сохраняет инструкции для пользователя, которые формируют то, как ИИ проводит мозговой штурм. Любое поле, оставленное без изменений, сохраняет предыдущее значение, поэтому вы можете обновлять по одному полю за раз.

Ввод:

• scope (str): "global" (по умолчанию для всей машины) или "project" (переопределение для одного проекта — требует project_path)

• project_path (str, опционально): Абсолютный путь к проекту. Требуется, когда scope="project". Используется как ключ поиска; сам файл хранится централизованно в ~/.mcp/brainstorm-mcp/preferences/projects/.

• uiux_level (str, опционально): Уровень навыков UI/UX пользователя (свободный текст). Предлагаемые значения: never_before, amateur, intermediate, expert.

• uiux_style (str, опционально): Стиль UI/UX проекта (свободный текст). Примеры: corporate internal tool, marketing-heavy landing page, children education app.

• questioning_style (str, опционально): Как ИИ должен задавать вопросы пользователю. Предлагаемые значения: autonomous_review (ИИ строит, пользователь проверяет с минимальным количеством вопросов) или collaborative_stepwise (ИИ проводит мозговой штурм шаг за шагом, задавая много вопросов для схождения к задуманному UI).

Вывод: Эффективные настройки после слияния (проект переопределяет глобальные настройки, поле за полем), плюс источник каждого поля.

get_brainstorm_preferences

Считывает эффективные настройки мозгового штурма. Значения проекта переопределяют глобальные значения поле за полем.

Ввод:

• project_path (str, опционально): Абсолютный путь к проекту для слияния с глобальными настройками по умолчанию. Пропустите, чтобы прочитать только глобальные настройки.

Вывод: Тот же формат, что и у set_brainstorm_preferences. ИИ также получает этот объект встроенным в каждый ответ start_brainstorm_session, поэтому ему никогда не нужно спрашивать дважды.

Принципы проектирования

• Минимальное использование ресурсов: Работа одного пользователя, отсутствие тяжелых зависимостей

• Без сохранения состояния, где это возможно: Сессии эфемерны, если не сохранены на диск

• Легкость ссылки: Автоматически генерируемые ID на всех интерактивных элементах

• Дружелюбность к ИИ-агентам: Структурированный формат ответа для легкого парсинга и продолжения

• Визуальная ясность: Четкое разделение разделов UI с рендерингом markdown/mermaid

Будущие улучшения

• Постоянная история сессий

• Совместная работа в реальном времени (будущая поддержка нескольких пользователей)

• Пользовательская библиотека компонентов Tailwind для шаблонов мозгового штурма

• Встроенный экспорт в различные форматы (PDF, PNG и т.д.)

• Интеграция с git для автоматического версионирования планов

Лицензия

MIT

Участие в разработке

Приветствуется участие. Пожалуйста, следуйте PEP 8 для кода на Python и убедитесь, что сервер остается легким.