pmMCP by r2cuerdame - MCP Server

pmMCP - 자율 실행 프로젝트 매니저

다른 컴퓨터에서 맞춤형 PM처럼 계속적으로 채찍질해서 프로젝트를 자동으로 완성시키는 MCP

Python 기반 자율 실행 프로젝트 관리 시스템입니다. 원격 컴퓨터에 설치되어 프로젝트를 지속적으로 모니터링하고 자동으로 개선합니다.

🎯 핵심 기능

🤖 자율 프로젝트 관리: AI 기반 작업 생성 및 자동 실행
🔧 원격 에이전트 설치: init 기능으로 다른 컴퓨터에 자동 설치
⚡ Claude Code 자동 실행: 프로젝트 개선을 위한 자동 명령 실행
📡 SSE MCP 연결: 실시간 양방향 통신
🔄 지속적 모니터링: 설정된 간격으로 프로젝트 상태 확인
🎯 스마트 트리거: 조건부 자동 실행 시스템
💪 프로젝트 채찍질: PM처럼 지속적으로 프로젝트 진행 추진

🚀 사용법

1. pmMCP 서버 시작

cd /home/ubuntu/pmMCP
python3 server.py

서버는 http://15.165.61.104:8888에서 실행됩니다.

2. 원격 에이전트 설치

Claude Code에서 pmMCP MCP 도구 사용:

// 원격 컴퓨터에 에이전트 설치
init_remote_agent({
  "target_info": {
    "host": "192.168.1.100",
    "username": "ubuntu",
    "password": "your_password"  // 또는 key_file 사용
  },
  "project_name": "my_awesome_project",
  "agent_config": {
    "check_interval": 30,  // 30분마다 체크
    "project_paths": ["/home/ubuntu/my_project"],
    "install_claude_code": true,
    "auto_start": true
  }
})

3. 원격 컴퓨터에서 MCP 설정

설치 완료 후 원격 컴퓨터의 Claude Code 설정에 추가:

{
  "pmMCP": {
    "type": "sse",
    "url": "http://15.165.61.104:8888/mcp/aws/sse/my_awesome_project",
    "env": {}
  }
}

4. 자동 실행 확인

원격 컴퓨터에서 자동으로:

30분마다 프로젝트 상태 확인
필요시 Claude Code 명령 자동 실행
개선 작업 수행 및 결과 보고

🛠️ MCP 도구

pmMCP는 다음 MCP 도구들을 제공합니다:

도구명	설명
`add_project`	새 프로젝트 추가
`list_projects`	프로젝트 목록 조회
`get_project_status`	프로젝트 상태 확인
`add_task`	작업 추가
`execute_task`	작업 실행
`execute_claude_command`	Claude 명령 실행
`add_trigger`	트리거 추가
`start_whipping_session`	채찍질 세션 시작
`init_remote_agent`	원격 에이전트 설치

🚀 init_remote_agent (핵심 도구)

원격 컴퓨터에 자동실행 에이전트를 설치하고 pmMCP와 연결합니다.

파라미터:

target_info (필수): SSH 연결 정보
- host: 대상 서버 IP/호스트
- username: SSH 사용자명
- password 또는 key_file: 인증 정보
project_name (필수): 프로젝트명 (SSE 연결용)
agent_config (선택): 에이전트 설정
- check_interval: 작업 확인 간격(분)
- project_paths: 모니터링할 프로젝트 경로들
- install_claude_code: Claude Code 자동 설치
- auto_start: 설치 후 자동 시작

🏗️ 아키텍처

┌─────────────────┐    SSE MCP     ┌─────────────────┐
│   pmMCP 서버    │ ◄──────────────► │  원격 컴퓨터     │
│  (15.165.61.104)│                │  (Claude Code)  │
└─────────────────┘                └─────────────────┘
        │                                    │
        ├── 다중 에이전트 시스템               ├── 자동 실행 스크립트
        ├── 트리거 시스템                     ├── 크론탭 스케줄링
        ├── 채찍질 시스템                     └── 프로젝트 모니터링
        └── 원격 설치기

🔧 주요 컴포넌트

1. AutonomousProjectManager

프로젝트 자율 관리
6개 전문 에이전트 운영
다중 프로젝트 동시 모니터링

2. ClaudeCodeExecutor

원격 Claude Code 명령 실행
SSH 기반 안전한 연결
결과 수집 및 분석

3. TriggerSystem

조건부 자동 실행
시간/이벤트 기반 트리거
스마트 실행 로직

4. ProjectWhipSystem

프로젝트 "채찍질" 관리
지속적 개선 추진
진행률 모니터링

5. RemoteAgentInstaller

원격 시스템 자동 설치
Claude Code 환경 설정
크론탭 스케줄링 설정

🔄 자동 실행 워크플로우

크론탭 실행 → 설정된 간격으로 자동 시작
프로젝트 상태 확인 → 코드 품질, 테스트, 성능 분석
개선 필요 판단 → AI 기반 개선점 식별
Claude Code 실행 → 자동으로 개선 명령 실행
결과 분석 → 실행 결과 검증 및 평가
pmMCP 서버 보고 → 진행 상황을 서버에 보고
다음 주기 대기 → 설정된 간격만큼 대기 후 반복

🔍 모니터링 및 로깅

원격 컴퓨터

로그 위치: ~/.claude/auto_runner.log
크론탭: crontab -l로 확인
스크립트: ~/.claude/auto_runner.sh

pmMCP 서버

로그 위치: /tmp/autonomous_pm.log
실시간 로그: 콘솔 출력
상태 확인: MCP 도구 사용

🚨 문제 해결

연결 문제

# SSH 연결 테스트
ssh username@target_host

# Claude Code 설치 확인
claude --version

# 크론탭 확인
crontab -l

로그 확인

# 자동 실행 로그
tail -f ~/.claude/auto_runner.log

# 시스템 로그
journalctl -u cron -f

📄 라이선스

MIT License - 자유롭게 사용, 수정, 배포 가능

pmMCP: 당신의 프로젝트를 위한 AI 프로젝트 매니저 🤖✨