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)
설치 (수동)
# 의존성
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 첫 부팅 시:
~/Documents/K-Personal-MCP/가 이미 있으면 → 그 폴더 우선 사용 (K 의 기존 todos/notes 보존)- 없으면 → 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 는 작동 책임 안 짐.