MCP_ClaudeOps
Claude Code操作仪表板-提供会话监控、代理性能分析、成本跟踪、项目管理和GitHub同步的MCP服务器
主要功能
- 实时监控 -实时跟踪会话、代理和工具的使用情况
- 成本分析 -按型号显示令牌使用情况和成本,并通知预算
- 项目管理 -PRD→Epic→Task分层跟踪,坎班板
- 代理团队 -基于Persona的团队配置、角色分配、工作负载跟踪、模板
- 运行管线 -设计/运行/监视多级代理管道
- 任务工作流 -设计(Design)→批准→实施→自动化验证
- GitHub同步 -Epic/Task→GitHub Issue双向同步,发表报告评论
- 工作树隔离 -基于Git Worktree的Epic并行开发环境
- 项目上下文 -管理brief/tech/architecture/rules文档
- 会话报告 -自动会话报告和每日准备工作
- 89个MCP工具 -在Claude Code对话中直接查询/管理数据
- 自动收集8个Hook -自动记录会话/工具/代理/提示事件
- 韩文仪表板 -全UI韩语支持
架构
Claude Code
├── 8 Hooks ──────► Backend API (:48390)
│ ├── Fastify + WebSocket
│ ├── SQLite DB (~/.claudeops/claudeops.db)
│ └── GitHub CLI (gh) ── GitHub Issues
└── 89 MCP Tools ──► MCP Server (stdio)
│
└──► Backend API
Dashboard (:48391) ◄── WebSocket ── Backend
├── Next.js 16 + React 19
├── Tailwind CSS v4
└── 19페이지 실시간 대시보드配置包
| 包 | 说明 |
|---|---|
@claudeops/shared | 共享类型、常量、实用程序 |
@claudeops/backend | Fastify REST API+WebSocket서버 |
@claudeops/mcp-server | MCP协议服务器(89个工具) |
@claudeops/dashboard | Next.js16操作仪表板 |
@claudeops/cli | 服务管理CLI |
要求
- Node.js >= 20.0.0
- pnpm >=9.x
安装
快速安装(建议)
curl -fsSL https://raw.githubusercontent.com/skdkfk8758/MCP_ClaudeOps/main/install.sh | bash在安装后要监视的项目中:
cd /path/to/your-project
claudeops setup使用此命令可自动执行以下操作:
- 构建所有软件包
- 启动Backend服务(
:48390) - 启动Dashboard服务(
:48391) - MCP服务器
.claude/settings.local.json在中注册 - 安装8个Hook
完成后 重新启动Claude Code启用MCP服务器和Hook。
手动安装
git clone https://github.com/skdkfk8758/MCP_ClaudeOps.git
cd MCP_ClaudeOps
pnpm install
pnpm turbo run build在要监视的项目中:
cd /path/to/your-project
node /path/to/MCP_ClaudeOps/packages/cli/dist/index.js setup监视多个项目
您可以使用一个ClaudeOps实例监控多个项目:
# 프로젝트 A
cd /path/to/project-a
claudeops setup
# 프로젝트 B (서비스는 재사용, Hook/MCP만 등록)
cd /path/to/project-b
claudeops setup更新
快速更新
claudeops upgrade使用此命令可自动执行以下操作:
- 最新源代码pull(
git pull --ff-only) - 安装依赖性并重新构建所有软件包
- 迁移数据库模式(自动创建新表)
- 更新所有注册项目的MCP服务器/Hook路径
- 重新启动服务
claudeops upgrade # 글로벌 + 모든 등록 프로젝트 업데이트
claudeops upgrade --global # 글로벌 설치만 업데이트 (빌드 + DB + 서비스 재시작)
claudeops upgrade --db # DB 마이그레이션만 실행手动更新
# 1. 글로벌 업데이트
cd ~/.claudeops-install
git pull
pnpm install && pnpm turbo run build
# 2. 서비스 재시작
claudeops stop
claudeops start
# 3. 각 프로젝트에서 재설정
cd /path/to/your-project
claudeops setup确认已注册的项目
claudeops listclaudeops setup运行的项目将自动 ~/.claudeops/projects.json在中注册。 claudeops upgrade 将自动重置此列表中的所有项目。
CLI命令
claudeops setup # 전체 설치 (빌드 + 서비스 + MCP + Hook)
claudeops start # 서비스 시작 (all | backend | dashboard)
claudeops stop # 서비스 종료
claudeops status # 서비스 상태 확인
claudeops teardown # 서비스 중지 + 등록 해제
claudeops upgrade # 글로벌 업데이트 + 등록 프로젝트 재설정
claudeops list # 등록된 프로젝트 목록 조회
claudeops task create "제목" --priority P1 --label feature
claudeops task list --status implementation
claudeops task update --status done
claudeops task board # 터미널 칸반 보드
claudeops task link
claudeops prd create "제목" --vision "비전"
claudeops prd list
claudeops prd show
claudeops epic create "제목" --prd
claudeops epic list [--prd
]
claudeops epic show
claudeops report session
claudeops report standup [--date 2026-02-09]
claudeops github config # GitHub 설정 조회
claudeops github setup # GitHub 연결 설정
claudeops github sync epic # Epic → GitHub Issue 동기화
claudeops github sync task # Task → GitHub Issue 동기화
claudeops worktree create --project
[--epic ]
claudeops worktree list [--status ]
claudeops worktree merge
claudeops worktree remove
claudeops worktree context set --project
--type --title --content
claudeops worktree context get --project
[--type ]MCP工具(89个)
| 类别 | 工具 | 数量 |
|---|---|---|
| 会话 | 创建会话、结束会话、获取会话、列表会话、搜索会话 | 5 |
| 代理 | record_agent、list_agents、get_agent_performance、get_agent_stats | 4 |
| 活动 | record_event、list_event、get_event_timeline、record_tool_use、list_tool_events、get_tool_stats、record_prompt | 7 |
| 分析 | record_token_use、get_tokensummary、get_cost_analysis、get_dashboard_summary、analyze_session_patters、get_model_costs、get_budget_status | 7 |
| 设置 | get_config、update_config、set_budget_alert、check_budget、set_model_price、get_system_info | 6 |
| 任务 | 创建任务、更新任务、列表任务、移动任务、获取任务板、链接会话任务、设置任务分支、执行任务、设计任务、批准设计、实现任务、验证任务、获取验证、扫描任务约束、获取任务约束、自动分支、获取操作、范围划分 | 18 |
| 珠江三角洲 | create_prd、list_prds、update_prd | 3 |
| 史诗 | 创建图片、列表图片、更新图片、获取图片、链接图片任务 | 5 |
| 管线 | create_pipeline、list_pipelines、get_pipeline、execute_pipeline和cancel_pipeline,get_pipeline_status和get_resets | 7 |
| 蒂姆/佩索纳 | list_personas、create_persona、update_persona和delete_persona,create_team、list_teams、get_team、clone_team和archive_team,add_agent_to_toteam、remove_agent_from_team以及assign_team_to_totask,unsign_team_from_task,list_team_templates和get_workload | 15 |
| 报告 | generate_session_report、generate-standup | 2 |
| GitHub | sync_epic_to_github、sync_task_to_github、post_report_to_github、get_github_config、setup_github、sync_all | 6 |
| 工作树 | 创建工作树、列表工作树、合并工作树、设置项目文本、获取项目文本 | 5 |
| 项目 | resolve_project_path | 1 |
所有工具 claudeops_ 以前缀开头(例如: claudeops_create_session).
仪表板(第19页)
http://localhost:48391
| 页面 | 说明 |
|---|---|
/ | 仪表板-今天摘要+各型号成本图表+PRD/Epic统计信息 |
/sessions | 会话列表 |
/sessions/[id] | 会话详细信息(代理、事件时间轴) |
/agents | 代理性能(呼叫数、平均所需时间、成功率) |
/tokens | 代币&成本(输入/输出、预算情况、型号) |
/tools | 工具分析 |
/events | 实时事件 |
/tasks | 坎班板(backlog/待办事宜/进行中/评论/完成)+Epic/团队过滤器 |
/tasks/[id] | 任务详细信息+设计/实施/验证工作流+团队分配 |
/pipelines | 管线列表+预设模板 |
/pipelines/[id] | 管道编辑器(React Flow)+运行监控 |
/teams | 代理团队管理(Persona、角色分配、工作负载) |
/prds PRD列表(状态筛选器、卡片视图) | |
/prds/[id] PRD详细信息+连接的Epic列表 | |
/epics | Epic列表(进度条,PRD链接) |
/epics/[id] | Epic详细+子Task列表 |
/reports | 创建会话报告+支架 |
/worktrees | Worktree管理(创建/合并/删除,Epic连接) |
/settings | 型号价格、预算通知、GitHub设置、项目上下文 |
环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
CLAUDEOPS_BACKEND_PORT | 48390 | Backend API端口 |
CLAUDEOPS_DASHBOARD_PORT | 48391 | Dashboard端口 |
CLAUDEOPS_BACKEND_URL | http://localhost:48390 | MCP服务器→Backend连接URL |
CLAUDEOPS_HOME | ~/.claudeops-install | ClaudeOps安装目录 |
CLAUDEOPS_DATA_DIR | ~/.claudeops | 数据目录(SQLite DB) |
去除
cd /path/to/your-project
claudeops teardown技术堆栈
| 领域 | 技术 |
|---|---|
| 版本 | pnpm+Turborepo |
| 后端 | Fastify 5,@Fastify/websocket,better squelite 3 |
| MCP | @modelcontextprotocol/sdk |
| 仪表板 | Next.js 16、React 19、顺风CSS v4、React Query 5、@xyflow/React、Recharts |
| CLI | Commander.js |
| 语言 | TypeScript 5.9 |
许可证
麻省理工学院
