MCP Report Generator

Генератор HTML-отчётов и инструкций администратора через Model Context Protocol. Подключите к Claude Code и генерируйте документы одной командой.

MCP SSE FastAPI + Python Jinja2 Templates

MCP Endpoint SSE https://tpl.developing-site.ru/mcp/sse

Отчёт / Чеклист

Отчёт о статусе выполненных задач, шаги ручного тестирования и результаты E2E-тестов.

Статус-бейджи: выполнено / частично / ошибка
Боковая панель с цветными точками
Шаги ручной проверки с ожидаемым результатом
Сводная таблица E2E-тестов (PASS/FAIL/SKIP)
Карточки статистики

Превью шаблона →

Инструкция администратора

Пошаговая инструкция по админ-панели с таблицами полей и навигационными хлебными крошками.

Боковая панель с SVG-иконками и счётчиками
Блок с данными доступа (URL, логин, пароль)
Таблицы описания полей
Хлебные крошки (Админка → Страницы → ...)
Пошаговые инструкции

Превью шаблона →

MCP API

Серверная точка входа для Claude Code и других MCP-клиентов. Подключите один раз — генерируйте отчёты из любого проекта простой командой. Отчёты сохраняются на сервере и доступны по прямой ссылке.

3 инструмента: generate_report, generate_guide, list_reports
SSE-транспорт (Server-Sent Events) через HTTPS
Типизированные параметры (Pydantic-модели, JSON Schema)
Отчёты доступны по прямым ссылкам сразу после генерации
Светлая/тёмная тема, адаптивная вёрстка

Документация → Примеры →

Пример работы

Этот гайд сгенерирован MCP-сервером автоматически — 7 разделов, 15 скриншотов, боковая навигация, таблицы полей и пошаговые инструкции.

Обзор MCP Report Generator

Сгенерированная инструкция с 15 скриншотами Playwright, 7 разделами и полным описанием сервиса.

Открыть гайд →

Как это было сгенерировано — промпт для Claude

Сгенерируй обзорную инструкцию по MCP Report Generator.

Сначала сделай скриншоты сайта tpl.developing-site.ru
через Playwright (главная, документация, превью шаблонов,
тёмная тема) и загрузи их на сервер.

Затем вызови generate_guide с разделами:
1. Обзор сервиса (скриншоты hero + карточки)
2. Подключение (3 способа конфига с breadcrumbs)
3. Инструменты MCP (скриншот секции)
4. generate_report (параметры + превью результата)
5. generate_guide (параметры + превью результата)
6. Документация (обзор + модели + примеры)
7. Дизайн-система (цвета, иконки, тёмная тема)

Claude автоматически: 1) запускает Playwright и делает 15 скриншотов, 2) загружает их на сервер, 3) вызывает MCP-инструмент generate_guide с данными и ссылками на скриншоты.

Результат: Самодостаточный HTML (33 КБ) с боковой панелью, навигацией, таблицами полей, хлебными крошками, пошаговыми инструкциями и 15 скриншотами — доступен по прямой ссылке сразу после генерации.

Инструменты MCP

generate_report

Генерирует HTML-отчёт по задачам проекта с статусами, шагами проверки и результатами тестов.

project_name project_url date groups test_summary?

generate_guide

Генерирует HTML-инструкцию администратора с таблицами полей, хлебными крошками и шагами.

project_name admin_url credentials sections

list_reports

Список ранее сгенерированных отчётов на сервере с размерами, датами и ссылками.

без параметров

Подробнее: Полное описание параметров, модели данных и примеры JSON — в документации.

Тёмная тема: Все отчёты поддерживают светлую и тёмную тему. Добавьте "dark": true в параметры или попросите Claude: «Сгенерируй отчёт в тёмной теме». Пользователь также может переключить тему кнопкой в готовом документе.

Подключение к Claude Code

1 Создайте файл конфигурации .mcp.json в корне проекта или ~/.claude/mcp.json для глобального доступа из любого проекта.
2 Добавьте MCP-сервер с типом sse и URL https://tpl.developing-site.ru/mcp/sse (см. примеры конфигов ниже).
3 Перезапустите Claude Code. Три инструмента появятся автоматически: generate_report, generate_guide, list_reports.
4 Попросите Claude сгенерировать отчёт. Например: «Сгенерируй отчёт по проекту с результатами проверки». Claude вызовет инструмент и вернёт прямую ссылку на готовый HTML.

Примеры конфигурации

Проектный .mcp.json

{
  "mcpServers": {
    "reports": {
      "type": "sse",
      "url": "https://tpl.developing-site.ru/mcp/sse"
    }
  }
}

Файл в корне проекта. MCP-сервер доступен только из этого проекта.

Глобальный ~/.claude/mcp.json

{
  "mcpServers": {
    "reports": {
      "type": "sse",
      "url": "https://tpl.developing-site.ru/mcp/sse"
    }
  }
}

Домашняя директория пользователя. MCP-сервер доступен из любого проекта.

Совместно с другими серверами .mcp.json

{
  "mcpServers": {
    "claude-code": {
      "command": "claude",
      "args": ["mcp", "serve"]
    },
    "telegram": {
      "command": "mcp-telegram",
      "args": ["start"]
    },
    "reports": {
      "type": "sse",
      "url": "https://tpl.developing-site.ru/mcp/sse"
    }
  }
}

Просто добавьте "reports" в существующий mcpServers. Все серверы работают параллельно.

Дизайн-система

Цвета

Синий (акцент)
#2563eb / #818cf8

Зелёный (готово)
#16a34a / #22c55e

Оранжевый (внимание)
#d97706 / #f59e0b

Красный (ошибка)
#dc2626 / #ef4444

Общие компоненты

.sidebar

Фиксированная левая панель (260px), группы навигации, отслеживание скролла

.page-header + .summary-item

Шапка с карточками статистики (готово/инфо/внимание/ошибка)

.steps + .step-n

Нумерованные шаги с ожидаемым результатом

.note-info/warn/error/success

Цветные блоки-заметки с левой границей

.fields table

Таблица описания полей (Поле / Описание)

.path + .path-arrow

Хлебные крошки навигации

Полная документация: Все модели данных, параметры инструментов, примеры JSON и список из 17 SVG-иконок — на странице документации.