Менеджер проектов MCP (Терминал + Веб + Десктоп)

Этот проект поддерживает три интерфейса на базе одного бэкенда:

• Терминальный набор инструментов

• REST API + React UI

• MCP stdio сервер

• Опциональный десктопный лаунчер на Python (открывает браузер с локальным приложением)

Быстрый старт

1. Запустите инфраструктуру: docker compose up -d

2. Примените схему: psql postgresql://postgres:postgres@localhost:5432/mcp_pm -f backend/sql/schema.sql

3. Соберите фронтенд для http://localhost:4000/: npm run build

4. Запустите API-сервер: npm run start

Если сборка фронтенда отсутствует, / вернет понятное сообщение с дальнейшими шагами.

Отдельные режимы запуска

• Терминальный набор: npm run terminal

• MCP stdio сервер: npm run mcp

• Десктопный лаунчер (режим подключения): npm run desktop

• Десктопный лаунчер (автозапуск бэкенда): npm run desktop:start

Эквиваленты для рабочих областей бэкенда:

• npm --workspace backend run terminal

• npm --workspace backend run mcp

• npm --workspace backend run desktop

• npm --workspace backend run desktop:start

Дополнения API

• GET /api/projects/:id/plans (фильтры + пагинация)

• GET /api/projects/:id/plans/compare?againstVersion=N

• POST /api/plans/:planId/promote-baseline

• POST /api/analysis/summarize-codebase (сводка по всей папке, описания для каждого файла, конвейер Mermaid)

• Действие обратной связи включает needs_review

• Опции генерации структуры: profile, dryRun, overwriteStrategy

Безопасность файловой системы

Эндпоинты файловой системы ограничены FS_BASE_PATH (по умолчанию: рабочая директория бэкенда).