K-Personal MCP

Servidor de herramientas de automatización para K-Desktop-Agent — funciona sobre MCP (Model Context Protocol).

Herramientas proporcionadas

• cc_* — Pantalla/ratón/teclado (basado en PyAutoGUI)

• ui_* — Automatización de la interfaz de usuario de Windows (uiautomation, árbol de accesibilidad)

• web_* — Automatización de navegador headless (playwright)

• fm_* — Organización/búsqueda/copia de seguridad de archivos

• app_* — Ejecución de aplicaciones/ajustes preestablecidos/alias

• clip_* — Portapapeles/fragmentos

• db_* — Tareas/notas/hábitos (SQLite personal)

Related MCP server: computer-use-windows

Instalación (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"

Uso con K-Desktop-Agent

A partir de K-Desktop-Agent (KDA) v0.5.13+, el código de este servidor se incluye en el paquete dentro de setup.exe (<install_dir>/bundled-mcp/). En el primer arranque de KDA:

1. Si ~/Documents/K-Personal-MCP/ ya existe → se utiliza esa carpeta (se conservan las tareas/notas existentes de K).

2. Si no existe → se copia automáticamente bundled-mcp/ del directorio de instalación + se crea una nueva data/personal.db vacía.

→ K puede instalar KDA setup.exe una sola vez en un PC nuevo y todas las herramientas funcionarán de inmediato.

Ubicación de los datos

data/personal.db (SQLite) — tareas / notas / hábitos / fragmentos. Este archivo no se sube a git (.gitignore).

Licencia

Herramientas de automatización personal de K — otros pueden hacer fork/usarlas, pero K no se hace responsable de su funcionamiento.