K-Personal MCP

Сервер инструментов автоматизации для K-Desktop-Agent, работающий на базе MCP (Model Context Protocol).

Предоставляемые инструменты

• cc_* — экран/мышь/клавиатура (на базе PyAutoGUI)

• ui_* — автоматизация пользовательского интерфейса Windows (uiautomation, дерево доступности)

• web_* — автоматизация headless-браузера (playwright)

• fm_* — организация файлов / поиск / резервное копирование

• app_* — запуск приложений / пресеты / псевдонимы

• clip_* — буфер обмена / сниппеты

• db_* — списки дел / заметки / привычки (персональная SQLite)

Related MCP server: computer-use-windows

Установка (вручную)

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

2. Если папка отсутствует → выполняется автоматическое копирование из bundled-mcp/ в директории установки + создание новой пустой базы data/personal.db.

→ K может просто установить KDA через setup.exe на новом ПК, и все инструменты сразу заработают.

Расположение данных

data/personal.db (SQLite) — списки дел / заметки / привычки / сниппеты. Этот файл не отправляется в git (.gitignore).

Лицензия

Персональные инструменты автоматизации K — другие могут форкать/использовать их, но K не несет ответственности за их работу.