# K-Personal MCP

K-Desktop-Agent 의 자동화 도구 서버 — MCP (Model Context Protocol) 위에서 동작.

## 제공 도구

- **cc_*** — 화면/마우스/키보드 (PyAutoGUI 기반)
- **ui_*** — Windows UI Automation (uiautomation, accessibility tree)
- **web_*** — 헤드리스 브라우저 자동화 (playwright)
- **fm_*** — 파일 정리 / 검색 / 백업
- **app_*** — 앱 실행 / 프리셋 / 별명
- **clip_*** — 클립보드 / 스니펫
- **db_*** — todos / notes / habits (개인 SQLite)

## 설치 (수동)

```powershell
# 의존성
pip install -r requirements.txt
python -m playwright install chromium

# Codex CLI 에 등록
codex mcp add k-personal -- python "$env:USERPROFILE\Documents\K-Personal-MCP\server.py"

# 또는 Claude CLI 에 등록
claude mcp add k-personal -- python "$env:USERPROFILE\Documents\K-Personal-MCP\server.py"
```

## K-Desktop-Agent 와 함께 사용

K-Desktop-Agent (KDA) v0.5.13+ 부터는 setup.exe 안에 이 서버 코드가 함께 번들로 포함됩니다 (`<install_dir>/bundled-mcp/`). KDA 첫 부팅 시:

1. `~/Documents/K-Personal-MCP/` 가 이미 있으면 → 그 폴더 우선 사용 (K 의 기존 todos/notes 보존)
2. 없으면 → install dir 의 `bundled-mcp/` 를 자동 복사 + 빈 `data/personal.db` 새로 생성

→ K 가 새 PC 에서 KDA setup.exe 한 번만 깔면 바로 모든 도구 작동.

## 데이터 위치

`data/personal.db` (SQLite) — todos / notes / habits / 스니펫. **이 파일은 git push 안 됨** (.gitignore).

## 라이선스

K 의 개인 자동화 도구 — 다른 사람이 fork/사용해도 OK 지만 K 는 작동 책임 안 짐.