MCP Business AI Transformation

# MVP План - Краткая сводка ## ⏱️ Временные рамки: 1 неделя (32 часа работы) ## ✅ Что будет работать после MVP: 1. ✅ Данные сохраняются в PostgreSQL (не теряются при перезапуске) 2. ✅ Rate limiting работает через Redis 3. ✅ MCP протокол: `tools/list` и `tools/call` работают 4. ✅ Создание и получение задач через API 5. ✅ Базовая аутентификация через API ключи 6. ✅ Health checks показывают реальный статус сервисов ## ❌ Что НЕ входит в MVP (отложено): - ❌ Реальная интеграция с LLM (оставляем симуляцию) - ❌ Меж-агентная коммуникация через message bus - ❌ Интеграция Frontend с Backend - ❌ Система миграций БД - ❌ Все MCP методы (только tools) --- ## 📅 Расписание по дням ### День 1-2: Инфраструктура (12 часов) **Результат:** БД и Redis подключены, данные сохраняются **Задачи:** 1. Подключение к PostgreSQL (6ч) - Модуль database.py - Минимальные модели (Task, Tool) - Обновление TaskOrchestrator 2. Подключение к Redis (4ч) - Модуль redis_client.py - Обновление RateLimitingMiddleware 3. Валидация config и health checks (2ч) ### День 3-4: Функционал (10 часов) **Результат:** MCP протокол работает, задачи создаются **Задачи:** 1. Реализация MCP tools/list и tools/call (6ч) - Обновление ToolRegistry для БД - Реализация handlers в main.py 2. Исправление Agent Registry (2ч) - Генерация ID до создания - Безопасная работа с current_task 3. Базовая безопасность (2ч) - API ключи через env переменные ### День 5: Тестирование (8 часов) **Результат:** Все работает, баги исправлены **Задачи:** - Тестирование всех endpoints - Проверка сохранения данных - Исправление найденных проблем - Обновление документации --- ## 🎯 Критерии успеха MVP ### Обязательные: - [ ] Сервер запускается без ошибок - [ ] Health check показывает статус БД и Redis - [ ] Задачи сохраняются в БД и не теряются при перезапуске - [ ] MCP endpoint `/mcp` отвечает на `tools/list` и `tools/call` - [ ] Rate limiting работает (можно проверить через curl) - [ ] API требует аутентификацию (кроме health) ### Желательные: - [ ] Нет критических ошибок в логах - [ ] Базовые тесты проходят - [ ] Документация обновлена --- ## 📝 Файлы для создания/изменения ### Новые файлы (7): 1. `mcp_server/app/core/database.py` 2. `mcp_server/app/core/redis_client.py` 3. `mcp_server/app/core/models/db_models.py` ### Изменяемые файлы (8): 1. `mcp_server/app/main.py` - инициализация БД/Redis 2. `mcp_server/app/config.py` - валидация SECRET_KEY 3. `mcp_server/app/core/services/task_orchestrator.py` - работа с БД 4. `mcp_server/app/core/services/tool_registry.py` - работа с БД 5. `mcp_server/app/core/services/agent_registry.py` - исправление багов 6. `mcp_server/app/middleware/rate_limiting.py` - Redis 7. `mcp_server/app/middleware/auth.py` - API ключи 8. `mcp_server/app/api/v1/health.py` - реальные проверки --- ## 🚀 Быстрый старт ```bash # 1. Создать .env cat > .env << EOF DATABASE_URL=postgresql+asyncpg://postgres:password@localhost:5432/mcp_db REDIS_URL=redis://localhost:6379 SECRET_KEY=$(python -c "import secrets; print(secrets.token_urlsafe(32))") API_KEY=mcp-api-key-12345 EOF # 2. Запустить инфраструктуру docker-compose up -d postgres redis # 3. Установить зависимости cd mcp_server pip install -r requirements.txt # 4. Запустить сервер uvicorn app.main:app --reload ``` --- ## ⚠️ Важные решения для MVP 1. **LLM остается симуляцией** - реальная интеграция займет +8-10 часов 2. **Frontend не трогаем** - моки работают, интеграция не критична 3. **Используем init-db.sql** - миграции отложены 4. **Упрощенная аутентификация** - API ключи в env, не в БД 5. **Минимальные модели БД** - только Task и Tool, остальное позже --- ## 📊 Оценка времени | День | Задачи | Часы | Результат | |------|--------|------|-----------| | 1-2 | БД + Redis | 12 | Данные сохраняются | | 3-4 | MCP + Фиксы | 10 | Протокол работает | | 5 | Тесты | 8 | Все стабильно | | **ИТОГО** | | **30** | **MVP готов** | **Резерв:** 2 часа на непредвиденные проблемы --- ## ✅ Чеклист готовности Перед началом: - [ ] PostgreSQL запущен и доступен - [ ] Redis запущен и доступен - [ ] .env файл создан с правильными значениями - [ ] Зависимости установлены После завершения: - [ ] Все endpoints работают - [ ] Данные сохраняются в БД - [ ] Rate limiting работает - [ ] MCP протокол отвечает - [ ] Нет критических ошибок --- ## 🎓 Следующие шаги после MVP После завершения MVP можно добавить: 1. Реальную интеграцию с LLM (+8-10ч) 2. Message bus для агентов (+4-6ч) 3. Frontend интеграцию (+6-8ч) 4. Полную систему миграций (+4-6ч) 5. Расширенную безопасность (+4-6ч) Но это уже не критично для MVP!