MCP Activity Tracker

자동 worklog 작성을 위한 컴퓨터 활동 모니터링 MCP 서버입니다.

🎯 주요 기능

- 실시간 활동 모니터링: 프로세스, 브라우저, 입력 활동 추적
- 스마트 세션 분석: 활동 패턴 기반 업무 유형 자동 분류
- 자동 Worklog 제안: LG전자 Work Description 양식에 맞는 제안 생성
- 인텔리전트 알림: 비활성 시간 감지 및 작업 완료 알림
- 기존 서버 연동: mcp-sprint-work-logs와 완벽 통합

🚀 설치 및 실행

$3

- Node.js 14.0.0+
- Python 3.9+
- Windows 10/11 (현재 Windows 전용)

$3

``bash
npx mcp-activity-tracker
`

$3

`bash
npm install -g mcp-activity-tracker
pip install -r requirements.txt
`

$3

`json
{
"mcp-activity-tracker": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-activity-tracker"],
"env": {
"JIRA_URL": "https://your-jira-instance.com/",
"JIRA_USERNAME": "your-username",
"JIRA_PASSWORD": "your-password-or-token"
}
}
}
`

🛠️ 사용 가능한 도구

$3

백그라운드 활동 모니터링을 시작합니다.
`javascript
await start_activity_monitoring();
`

$3

활동 요약을 조회합니다.
`javascript
await get_activity_summary("2024-01-15");
await get_activity_summary(null, "2024-01-15T09:00:00", "2024-01-15T18:00:00");
`

$3

대기 중인 worklog 제안을 조회합니다.
`javascript
await get_worklog_suggestions();
`

$3

worklog 제안을 승인하고 실제 worklog를 생성합니다.
`javascript
await approve_worklog_suggestion(1, {
"summary": "수정된 업무 내용",
"time_spent": "2h"
});
`

$3

일일 요약 알림을 표시합니다.
`javascript
await show_daily_summary_notification();
`

📊 활동 분류 시스템

$3

`python
activity_patterns = {
"개발": ["vscode", "git", "github", "gerrit", "putty", "ssh"],
"이슈": ["jira", "bugzilla", "mantis"],
"운영": ["outlook", "excel", "powerpoint", "teams", "zoom", "webex", "meet"]
}
`

$3

- 개발: 코드 개발, API 구현, 팀장회의 등
- 이슈: Jira 이슈 처리, 버그 분석, 인증 문제 등
- 지원: Sanity Test, 현장 지원, 운영 지원 등
- 운영: 회의, 이사, 월례조회, 간사 활동 등
- 휴가/교육: Personal Work Log 자동 분류

🔔 스마트 알림 시스템

$3

30분 이상 비활성 후 복귀 시:
`
"회의 다녀오셨나요? worklog를 작성할까요?"
`

$3

작업 창 그룹 닫기 감지 시:
`
"VSCode + Gerrit 작업이 완료된 것 같습니다.
2시간 개발 작업을 worklog에 추가할까요?"
`

$3

하루 종료 시:
`
"오늘 3개의 미작성 worklog가 있습니다. 자동 생성할까요?"
`

🗄️ 데이터 저장

$3

- activities: 기본 활동 로그
- sessions: 활동 세션 그룹화
- worklog_suggestions: 제안된 worklog
- user_preferences: 사용자 설정
- activity_rules: 활동 분류 규칙

$3

- 모든 데이터는 로컬에 저장
- 민감한 URL 자동 필터링
- 사용자 동의 기반 수집
- 30일 후 자동 정리

🔗 기존 서버 연동

mcp-sprint-work-logs 서버와 완벽 통합:
- 동일한 환경변수 사용
- create_work_entry 함수 직접 호출
- 현재 스프린트 이슈 자동 연결
- LG전자 Work Description 양식 준수

⚙️ 설정 옵션

$3

`javascript
await configure_monitoring_settings({
"check_interval": 5, // 체크 간격 (초)
"inactivity_threshold": 30, // 비활성 임계값 (분)
"min_session_duration": 15, // 최소 세션 시간 (분)
"auto_approve": false // 자동 승인 여부
});
``

🚨 문제 해결

$3

- 관리자 권한으로 실행
- 보안 소프트웨어 예외 설정

$3

- 브라우저 완전 종료 후 재시도
- 브라우저 설정에서 히스토리 허용 확인

$3

- Windows 알림 설정 확인
- plyer 라이브러리 재설치

📈 성능 최적화

- CPU 사용률 < 1%
- 메모리 사용량 < 50MB
- 배치 처리로 DB 최적화
- 자동 데이터 정리

🔮 향후 계획

- Phase 2: 고급 패턴 학습
- Phase 3: 다중 모니터 지원
- Phase 4: 맥/리눅스 지원
- Phase 5: 팀 대시보드

📄 라이선스

MIT License

👨‍💻 개발자

jaehyung1.lee - LG전자 SW개발담당