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)

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 の既存の todos/notes を保持)

2. 存在しない場合 → インストールディレクトリの bundled-mcp/ を自動コピー + 空の data/personal.db を新規作成

→ K が新しい PC で KDA setup.exe を一度インストールするだけで、すべてのツールがすぐに動作します。

データ保存場所

data/personal.db (SQLite) — todos / notes / habits / スニペット。このファイルは git push されません (.gitignore)。

ライセンス

K の個人用自動化ツール — 他の人が fork/使用しても OK ですが、K は動作の責任を負いません。