K-Personal MCP

K-Desktop-Agent 的自动化工具服务器 — 基于 MCP (Model Context Protocol) 运行。

提供工具

• cc_* — 屏幕/鼠标/键盘 (基于 PyAutoGUI)

• ui_* — Windows UI 自动化 (uiautomation, accessibility tree)

• web_* — 无头浏览器自动化 (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 push (.gitignore)。

许可

K 的个人自动化工具 — 其他人可以 fork/使用，但 K 不承担运行责任。