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