Create MCP Pm

英语 | 韩语

MCP项目经理

与Claude Code集成的综合项目管理和工作流跟踪系统。基于Model Context Protocol（MCP）自动捕获Claude Code会话、使用工具、运行代理和项目任务，并将其存储在集中式仪表板和数据库中。

](https://github.com/skdkfk8758/MCP-ProjectManager)  ](https://nodejs.org/)   

Fork信息：此项目 croffasia/mcp项目经理通过分支扩展到3-tier体系结构的版本。

目录

• 概要
• 主要功能
• 架构
• 快速入门
• 安装
• MCP客户端设置
• 开发
• 技术堆栈
• 许可证

概要

MCP Project Manager是将Claude Code工作流转换为可执行洞察的3-tier系统。自动跟踪以下内容：

• 会话活动和时间轴
• 工具使用模式和性能
• 运行代理并调用技能
• 项目任务、里程碑、交付项
• 文件更改和代码度量
• 团队分析和洞察

提供可视化仪表板、REST API，并通过MCP与Claude Desktop无缝集成。

核心功能

• 自动事件捕获：8个Claude Code钩子处理器自动捕获会话、工具、代理和提示符，无需用户干预
• 实时仪表板：通过WebSocket实时更新、坎班板、流程图、分析图表
• 流可视化：基于图形的Agent运行、工具调用和决策流程视图
• 智能分析：令牌使用率、代理分布、成功率、时间轴洞察
• 项目管理：创建项目、跟踪任务、设置里程碑、管理交付项
• 一键安装: npx create-mcp-pm自动处理此克隆、构建、设置和MCP注册

主要功能

33个MCP工具

跟踪流和会话（12个）

• flow_session_start / flow_session_end -会话生命周期管理
• flow_task_start / flow_task_end -跟踪任务执行
• flow_skill_call -技能呼叫记录
• flow_error -记录错误事件
• flow_agent_spawn / flow_agent_complete -代理生命周期
• flow_tool_call -工具运行历史记录
• flow_file_change -跟踪文件更改
• flow_commit -Git提交历史记录
• flow_prompt -记录用户提示

项目管理CRUD（15个）

• 项目: pm_project_create, pm_project_update, pm_project_delete, pm_project_list, pm_project_get
• 工作: pm_task_create, pm_task_update, pm_task_delete, pm_task_list, pm_task_get
• 里程碑: pm_milestone_create, pm_milestone_update, pm_milestone_list
• 管理任务: pm_task_move, pm_task_assign_priority

查询和分析（6个）

• pm_dashboard_summary -KPI摘要和项目统计
• pm_timeline -查看事件时间轴
• pm_flow_graph -流程图数据
• pm_analyze_bottleneck -瓶颈分析
• pm_suggest_next_task -建议执行以下操作
• pm_report_generate -生成项目报告

自我更新（1个）

• pm_self_update -自动将已安装的MCP服务器更新到最新版本

8个Claude Code钩子处理程序

通过Claude Code钩子自动捕获事件：

“钩子”“事件”“捕获内容” |------|-------|----------| | session-start | SessionStart |初始化新会话| | session-end | SessionEnd |会话完成和摘要| | pre-tool-use | PreToolUse |工具运行前| | post-tool-use | PostToolUse |工具完成，文件更改| | subagent-start SubagentStart创建代理 | subagent-stop | SubagentStop |代理完成| | user-prompt-submit | UserPromptSubmit |用户提示和查询| | stop 停止优雅的结束

仪表板功能

核心视图

• 概述页面 (/：KPI卡、项目统计、趋势图（recharts）
• 项目页面 (/projects：项目列表和进度
• 项目详细信息 (/projects/[id]):

- 第7步坎班板（待办事宜/设计/实施/评论/测试/完成/存档） - 管理拖放操作（@dnd-kit） - 工作卡动作：编辑、删除、启动/停止运行 - 任务运行跟踪（WebSocket实时更新）

• 时间轴 (/projects/[id]/timeline：按事件时间顺序查询
• 流程图 (/projects/[id]/flow：可视化代理执行树（@xyflow/react v12）
• 活动页面 (/activities：事件列表和筛选
• 分析页面 (/analytics：任务完成率、令牌使用率、代理分布、会话活动
• 设置页面 (/settings：服务状态，数据库信息

实时更新

• 基于WebSocket的实时更新（无轮询）
• 坎班板的乐观更新
• 实时会话跟踪

运行会话和任务

• 创建和管理会话
• 启动/停止任务
• 跟踪工作步骤（设计/实施/评论/测试）
• 实时监控运行状态

架构

第三层设计

┌─────────────────────────────────────────┐
│         Claude Desktop / Claude Code    │
│              (MCP Client)               │
└──────────────┬──────────────────────────┘
               │
               │ MCP Protocol
               ▼
┌─────────────────────────────────────────┐
│    MCP Server (TypeScript)              │
│  33 Tools + 8 Hook Handlers             │
│  • Flow Events & Sessions               │
│  • Project Management CRUD              │
│  • Analytics & Queries                  │
└──────────────┬──────────────────────────┘
               │
               │ REST API / WebSocket
               ▼
┌─────────────────────────────────────────┐
│   FastAPI Backend (Python 3.14)         │
│   SQLAlchemy ORM + SQLite (WAL)         │
│   • 15 database tables                  │
│   • Real-time WebSocket updates         │
│   • Async/await execution               │
└──────────────┬──────────────────────────┘
               │
               │ WebSocket / HTTP
               ▼
┌─────────────────────────────────────────┐
│    Next.js Dashboard (React 19)         │
│   • Kanban board with drag-and-drop     │
│   • Flow graph visualization            │
│   • Analytics & timeline views          │
│   • Real-time project tracking          │
└─────────────────────────────────────────┘

包结构

packages/
├── mcp-server/    # TypeScript MCP Server (tsup build)
│   └── src/tools/ # 33 MCP tools
│       ├── flow-events.ts, flow-session.ts, flow-agent.ts, flow-tracking.ts
│       ├── pm-project.ts, pm-task.ts, pm-milestone.ts, pm-actions.ts
│       ├── pm-query.ts, pm-analysis.ts, pm-session.ts, pm-update.ts
│       └── index.ts
├── backend/       # FastAPI (Python 3.14) REST API + WebSocket
│   └── app/routes/ # projects, tasks, sessions, milestones, events, analytics, ws, seed, ai, labels
├── dashboard/     # Next.js 15 (App Router) Web Dashboard
│   └── src/app/   # pages: /, activities, analytics, projects, projects/[id] (kanban/timeline/flow), settings
├── cli/           # CLI tools
└── create-mcp-pm/ # Project scaffolding

数据库：SQLite（WAL模式）位于 ~/.mcp-pm/mcp_pm.db，15张桌子 港口：后端48293，仪表板48294

快速入门

安装

最快的入门方法：

# 옵션 1: GitHub에서 직접 설치 (npm 계정 불필요)
curl -fsSL https://raw.githubusercontent.com/skdkfk8758/MCP-ProjectManager/main/scripts/install.sh | bash

# 옵션 2: npx (npm publish 후 사용 가능)
npx create-mcp-pm

这一单一命令执行以下操作：

1. 验证必需的依赖性（Node.js 20+、Python3.14+、git）
2. MCP ProjectManager存储库克隆
3. 通过pnpm安装所有依赖性
4. 构建所有软件包（MCP Server、CLI、Dashboard、Backend）
5. 设置Python后端虚拟环境
6. 在Claude Desktop中注册MCP服务器
7. 安装Claude Code钩子处理程序

手动设置（用于开发）

本地开发时：

# 저장소 클론
git clone https://github.com/skdkfk8758/MCP-ProjectManager.git
cd MCP_ProjectManager

# 의존성 설치
pnpm install

# 모든 패키지 빌드
pnpm build

# Python 백엔드 설정
cd packages/backend
python3 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -e .
cd ../..

# Claude Desktop 등록 및 훅 설치
mcp-pm setup

# 서비스 시작
mcp-pm start

连接仪表板

运行后：

• 仪表板: http://localhost:48294
• 后端API: http://localhost:48293
• API文档: http://localhost:48293/docs

演示数据

通过种子演示数据立即查看所有仪表板功能：

# 데모 데이터 시드 (3 프로젝트, 26 작업, 분석 데이터, 에이전트 통계)
bash scripts/seed-demo.sh

# 모든 데이터 초기화
bash scripts/seed-demo.sh reset

# 또는 API 직접 호출
curl -X POST http://localhost:48293/api/seed/demo
curl -X POST http://localhost:48293/api/seed/reset

MCP客户端设置

克劳德桌面版

~/.claude/settings.local.json在中添加以下内容：

{
  "mcpServers": {
    "mcp-project-manager": {
      "command": "node",
      "args": ["/Users/carpdm/Documents/mcp_servers/MCP_ProjectManager/packages/mcp-server/dist/index.js"]
    }
  }
}

克劳德代码

Hook Handler mcp-pm setup 运行时自动注册。

光标/VS代码

安装MCP扩展程序后，使用上述设置。

开发

要求

• Node.js 20.0.0或更高版本
• Python 3.14或更高版本
• pnpm 9.0.0或更高版本
• 版本控制系统

构建命令

# 모든 패키지 빌드
pnpm turbo build

# 개별 패키지 빌드
pnpm build -F @mcp-pm/server
pnpm build -F @mcp-pm/backend
pnpm build -F @mcp-pm/dashboard
pnpm build -F @mcp-pm/cli

# 개발 모드 (watch)
pnpm dev

# 린팅
pnpm lint

# 빌드 아티팩트 정리
pnpm clean

开发工作流

后端启动

cd packages/backend
source .venv/bin/activate  # Windows: .venv\Scripts\activate
python main.py
# http://localhost:48293에서 실행

启动仪表板

cd packages/dashboard
pnpm dev
# http://localhost:48294에서 실행

MCP服务器（用于本地测试）

cd packages/mcp-server
pnpm dev

主要开发说明

• 异步python：后端使用SQLAlchemy异步ORM。调用数据库时始终await
• Greenlet要求：aiosqlite+SQLAlchemy异步兼容性必需
• Next.js 15路由：动态路由params是Promise。 use()需要卸载
• 钩子处理程序: packages/mcp-server/src/hooks/位置。防止Claude Code阻止的fire-and-forget模式
• TypeScript严格：使用TypeScript strict模式。 pnpm lint确认为

技术堆栈

CLI命令

mcp-pm 通过CLI管理项目：

# 전체 설정: 환경 확인, 빌드, 서비스 시작, MCP 등록
mcp-pm setup

# 서비스 시작 (백엔드 + 대시보드)
mcp-pm start [service]     # service: backend, dashboard, 또는 all (기본값)

# 모든 실행 중인 서비스 중지
mcp-pm stop

# 서비스 상태, 빌드, 훅, 데이터베이스 확인
mcp-pm status

# 이 프로젝트의 MCP 서버 및 훅을 Claude Desktop에서 제거
mcp-pm teardown

文件

• 工具参考 -33个MCP工具详细说明
• 提示指南 -与Claude一起使用的提示示例
• 体系结构文档 -系统设计和数据流

许可证

MIT License-详细信息 许可证 文件引用

版权所有（c）2025 MCP项目经理贡献者

感谢的文章

采用以下技术构建：

• 模型上下文协议 通过Anthropic
• TypeScript
• 快速API
• Next.js
• 反应
• 尾风CSS
• SQLAlchemy

支持

问题和问题：

• GitHub问题：https://github.com/skdkfk8758/MCP-ProjectManager/issues
• 讨论：https://github.com/skdkfk8758/MCP-ProjectManager/discussions

______________________________________________________________________

准备好开始了吗？ npx create-mcp-pm启动Claude Code工作流跟踪！