代码运营监控平台

MCP_ClaudeOps是一个提供实时会话监控、代理性能分析、成本追踪和项目管理的代码运营监控平台,适用于开发团队进行项目协同与效能分析。

  • by skdkfk8758
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 skdkfk8758/MCP_ClaudeOps

使用说明

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

使用此命令可自动执行以下操作:

  1. 构建所有软件包
  2. 启动Backend服务(:48390)
  3. 启动Dashboard服务(:48391)
  4. MCP服务器 .claude/settings.local.json在中注册
  5. 安装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

使用此命令可自动执行以下操作:

  1. 最新源代码pull(git pull --ff-only)
  2. 安装依赖性并重新构建所有软件包
  3. 迁移数据库模式(自动创建新表)
  4. 更新所有注册项目的MCP服务器/Hook路径
  5. 重新启动服务
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 list

claudeops 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 <id> --status done
claudeops task board   # 터미널 칸반 보드
claudeops task link <task_id> <session_id>

claudeops prd create "제목" --vision "비전"
claudeops prd list
claudeops prd show <id>

claudeops epic create "제목" --prd <prd_id>
claudeops epic list [--prd <prd_id>]
claudeops epic show <id>

claudeops report session <session_id>
claudeops report standup [--date 2026-02-09]

claudeops github config          # GitHub 설정 조회
claudeops github setup           # GitHub 연결 설정
claudeops github sync epic <id>  # Epic → GitHub Issue 동기화
claudeops github sync task <id>  # Task → GitHub Issue 동기화

claudeops worktree create <name> --project <path> [--epic <id>]
claudeops worktree list [--status <status>]
claudeops worktree merge <id>
claudeops worktree remove <id>
claudeops worktree context set --project <path> --type <type> --title <title> --content <content>
claudeops worktree context get --project <path> [--type <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

许可证

麻省理工学院