# 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. Источник правды: код и конфигурация проекта.*