AK Screen MCP

Controla AK Screen desde Claude Desktop, Claude Code, Codex u otro cliente MCP compatible con stdio. El agente usa los comandos reales del editor: clips, efectos, texto, subtítulos, cámara, gráficos, fotogramas clave, audio y exportación.

Compatible con AK Screen 3.0 y versiones posteriores.

Descargar AK Screen · Repositorio de descargas · Skill complementaria

Instala AK Screen 3.0 o posterior y conecta el MCP al ejecutable de esa versión.

Instalación

Necesitas Python 3.10 o posterior. Con uv:

uvx --from git+https://github.com/Edgajuman/AKScreen-MCP ak-screen-mcp --launch "C:/ruta/a/AKScreen.exe"

También puedes clonar el repositorio y ejecutar python -m pip install .. No hay dependencias de ejecución ni cuenta online para controlar el editor.

Related MCP server: YoloCut

Claude Desktop y otros clientes stdio

Añade esta entrada a la configuración MCP de tu cliente, sustituyendo la ruta:

{
  "mcpServers": {
    "ak-screen": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/Edgajuman/AKScreen-MCP",
        "ak-screen-mcp", "--launch", "C:/ruta/a/AKScreen.exe"
      ]
    }
  }
}

El modo --launch inicia una sesión del editor con una clave aleatoria en memoria. El editor no se cierra al desconectar al agente: tu trabajo sin guardar se conserva. Para otra instancia usa --port 9877 en la configuración de ese servidor.

Si prefieres iniciar el editor tú mismo, define AKSCREEN_CONTROL_TOKEN (32–256 caracteres ASCII imprimibles sin espacios) para ambos procesos, ejecuta AKScreen.exe --control 9876, y después ak-screen-mcp --port 9876. No publiques esa clave ni la compartas con servicios externos. La conexión se limita a 127.0.0.1.

Skill complementaria

Instala AK Screen Editing. El MCP proporciona herramientas; la skill explica cómo editar con ellas, descubrir comandos, verificar el resultado y conservar el proyecto original.

Ejemplos de peticiones:

• «Abre mi proyecto, aplica una corrección suave al segundo clip y muéstrame el resultado».

• «Crea un rótulo con mi fuente local y anima su entrada durante un segundo».

• «Aplica un movimiento de cámara y añade un gráfico de barras con estos datos».

• «Recorta las pausas que te indiqué y exporta una copia MP4 a esta carpeta».

• «Sigue este objeto y vincula el título a su recorrido».

• «Crea un espectro circular editable con este clip de música».

• «Genera partículas con gravedad y haz que la cámara siga el título».

En AK Screen 3.0 el mismo registro incluye tracking.*, audio.reactive, audio.spectrum, physics.emitter, camera.target y motion.blur. El agente descubre sus parámetros en el editor instalado. Los análisis son trabajos cancelables: consulta jobs.list y espera su resultado antes de editar la secuencia. Las capas y claves generadas se guardan en el proyecto.

Herramientas

Cada edición utiliza el historial del editor. Un lote no es una transacción: puede haber cambios aplicados antes de un error. Una operación cuyo resultado se perdió por desconexión no se reintenta automáticamente.

Las exportaciones se envían como trabajos en segundo plano. Consulta jobs.list mediante command_run para conocer su estado, sin iniciar otra exportación.

Desarrollo

python -m pip install -e .
python -m unittest discover -s tests

Las pruebas verifican protocolo stdio, autenticación local, límites, lotes, desconexiones y recuperación de errores frente a un editor de prueba.

MIT · @edgajuman. El canal de comandos proviene de la arquitectura abierta de FilmCraft; el puente, la autenticación y esta distribución de AK Screen se mantienen aquí.