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

generate_report

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

project_name project_url date groups test_summary?

generate_guide

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

project_name admin_url credentials sections

list_reports

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

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

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

Подключение к 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-иконок — на странице документации.