MCP_ClaudeOps

Claude Code 운영 대시보드 - 세션 모니터링, 에이전트 성능 분석, 비용 추적, 프로젝트 관리, GitHub 동기화를 제공하는 MCP 서버

주요 기능

실시간 모니터링 - 세션, 에이전트, 도구 사용 실시간 추적
비용 분석 - 모델별 토큰 사용량 및 비용 시각화, 예산 알림
프로젝트 관리 - PRD → Epic → Task 계층적 추적, 칸반 보드
에이전트 팀 - 페르소나 기반 팀 구성, 역할 배정, 워크로드 추적, 템플릿
파이프라인 실행 - 다단계 에이전트 파이프라인 설계/실행/모니터링
태스크 워크플로우 - 설계(Design) → 승인 → 구현 → 검증 자동화
GitHub 동기화 - Epic/Task → GitHub Issue 양방향 동기화, 리포트 댓글 게시
Worktree 격리 - 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.js 16 운영 대시보드
`@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)
의존성 설치 및 모든 패키지 재빌드
DB 스키마 마이그레이션 (새 테이블 자동 생성)
등록된 모든 프로젝트의 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 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개)

카테고리	도구	수
세션	create_session, end_session, get_session, list_sessions, search_sessions	5
에이전트	record_agent, list_agents, get_agent_performance, get_agent_stats	4
이벤트	record_event, list_events, get_event_timeline, record_tool_use, list_tool_events, get_tool_stats, record_prompt	7
분석	record_token_usage, get_token_summary, get_cost_analysis, get_dashboard_summary, analyze_session_patterns, get_model_costs, get_budget_status	7
설정	get_config, update_config, set_budget_alert, check_budget, set_model_price, get_system_info	6
태스크	create_task, update_task, list_tasks, move_task, get_task_board, link_session_to_task, set_task_branch, execute_task, design_task, approve_design, implement_task, verify_task, get_verification, scan_task_commits, get_task_commits, auto_branch, get_scope_proposal, scope_split	18
PRD	create_prd, list_prds, update_prd	3
에픽	create_epic, list_epics, update_epic, get_epic, link_epic_tasks	5
파이프라인	create_pipeline, list_pipelines, get_pipeline, execute_pipeline, cancel_pipeline, get_pipeline_status, get_presets	7
팀/페르소나	list_personas, create_persona, update_persona, delete_persona, create_team, list_teams, get_team, clone_team, archive_team, add_agent_to_team, remove_agent_from_team, assign_team_to_task, unassign_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
Worktree	create_worktree, list_worktrees, merge_worktree, set_project_context, get_project_context	5
프로젝트	resolve_project_path	1

모든 도구는 claudeops_ 접두사로 시작합니다 (예: claudeops_create_session).

대시보드 (19페이지)

http://localhost:48391

페이지	설명
`/`	대시보드 - 오늘 요약 + 모델별 비용 차트 + PRD/Epic 통계
`/sessions`	세션 목록
`/sessions/[id]`	세션 상세 (에이전트, 이벤트 타임라인)
`/agents`	에이전트 성능 (호출 수, 평균 소요 시간, 성공률)
`/tokens`	토큰 & 비용 (입력/출력, 예산 현황, 모델별)
`/tools`	도구 분석
`/events`	실시간 이벤트
`/tasks`	칸반 보드 (백로그/할 일/진행 중/리뷰/완료) + Epic/팀 필터
`/tasks/[id]`	태스크 상세 + 설계/구현/검증 워크플로우 + 팀 배정
`/pipelines`	파이프라인 목록 + 프리셋 템플릿
`/pipelines/[id]`	파이프라인 편집기 (React Flow) + 실행 모니터링
`/teams`	에이전트 팀 관리 (페르소나, 역할 배정, 워크로드)
`/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
Backend	Fastify 5, @fastify/websocket, better-sqlite3
MCP	@modelcontextprotocol/sdk
Dashboard	Next.js 16, React 19, Tailwind CSS v4, React Query 5, @xyflow/react, Recharts
CLI	Commander.js
언어	TypeScript 5.9

라이선스

MIT

MCP_ClaudeOps

MCP_ClaudeOps

주요 기능

아키텍처

패키지 구성

요구사항

설치

빠른 설치 (권장)

수동 설치

다중 프로젝트 모니터링

업데이트

빠른 업데이트

수동 업데이트

등록된 프로젝트 확인

CLI 명령어

MCP 도구 (89개)

대시보드 (19페이지)

환경 변수

제거

기술 스택

라이선스

Latest Blog Posts

MCP directory API