MCP 项目管理器 (终端 + Web + 桌面)

本项目通过一个后端支持三种接口：

• 终端套件

• 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（默认：后端工作目录）。