LazyBearWorks/memory-bank/projectbrief.md

Project Brief — LazyBear MCP Server

Обзор проекта

LazyBear MCP Server — .NET 10 сервер Model Context Protocol (MCP) для автоматизации работы с Jira, Confluence и Kubernetes.

Цель проекта

Предоставить единый HTTP-сервер MCP, который:

• Интегрируется с IDE (Codex, VS Code, OpenCode) через MCP протокол
• Предоставляет инструменты для управления Jira задачами (JQL, комментарии, обновления)
• Работает с Confluence страницами и пространствами
• Управляет Kubernetes ресурсами (deployments, pods, services, ingress)
• Предоставляет интерактивную TUI панель для мониторинга кластера

Ключевые требования

Функциональные требования

1. MCP Protocol 1.2.0 — HTTP transport по стандарту Model Context Protocol
2. Jira Integration — Создание, поиск, обновление Issues, работа с комментариями
3. Confluence Integration — Управление страницами, поиск, перемещение
4. Kubernetes Management — CRUD операции над deployments, pods, services, ingress
5. TUI Dashboard — Интерактивная консольная панель с RazorConsole
6. Localization — Поддержка RU/EN языков в интерфейсе

Технические требования

• .NET 10 SDK — SDK зафиксирован в global.json
• ASP.NET Core 9 — Для HTTP transport
• Razor Pages — UI компоненты (активируется при необходимости)
• Kubernetes Client — Подключение к K8s API через kubeconfig
• SQLite/SQL Server — Опциональная база данных
• Swagger UI — /swagger endpoint для просмотра API

Основные ограничения

• Jira: требуется настроить Jira:Url в appsettings.json
• Kubernetes: Kubernetes:KubeconfigPath может быть пустым (используются fallback)
• Конфиденциальность: никогда не хранить реальные секреты, токены, kubeconfig в коде

Архитектурные принципы

1. Single HTTP Server — Один транспорт MCP для всех инструментов
2. Tool Registry Pattern — Регистрация модулей инструментов через IToolModule
3. Client Provider Pattern — Factory для создания K8s/Jira/Confluence клиентов
4. TUI First — TUI как основной интерфейс, HTTP MCP в фоне
5. Minimal API Style — Clean code, разделение ответственности

Даты и версии

• Текущая версия: 1.0.0
• Состояние: Development
• Комит: d12e9873f0964f2c275a634cda80b161c83f9bbb

Репо (Git)

• Remote: https://git.shahovalov.ru/mikhail/LazyBearWorks.git
• Branch: main (предположительно)

---

Документ создан для инициализации Memory Bank. Источник правды: код и конфигурация проекта.