K-Personal MCP

Automation tool server for K-Desktop-Agent — running on MCP (Model Context Protocol).

Provided Tools

• cc_* — Screen/mouse/keyboard (based on PyAutoGUI)

• ui_* — Windows UI Automation (uiautomation, accessibility tree)

• web_* — Headless browser automation (playwright)

• fm_* — File organization / search / backup

• app_* — App execution / presets / aliases

• clip_* — Clipboard / snippets

• db_* — todos / notes / habits (personal SQLite)

Related MCP server: computer-use-windows

Installation (Manual)

# 의존성
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"

Using with K-Desktop-Agent

Starting from K-Desktop-Agent (KDA) v0.5.13+, this server code is bundled within setup.exe (<install_dir>/bundled-mcp/). Upon the first boot of KDA:

1. If ~/Documents/K-Personal-MCP/ already exists → use that folder first (preserves K's existing todos/notes)

2. If it does not exist → automatically copy bundled-mcp/ from the install dir + create a new empty data/personal.db

→ K can install KDA setup.exe once on a new PC and all tools will work immediately.

Data Location

data/personal.db (SQLite) — todos / notes / habits / snippets. This file is not git pushed (.gitignore).

License

K's personal automation tools — others are free to fork/use, but K takes no responsibility for operation.