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 첫 부팅 시:

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 는 작동 책임 안 짐.