MCP プロジェクトマネージャー (ターミナル + Web + デスクトップ)

本プロジェクトは、1つのバックエンドで3つのインターフェースをサポートしています：

• ターミナルスイート

• 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 (デフォルト: バックエンドの作業ディレクトリ) に制限されています。