Concat MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Concat MCP
Servidor MCP que deja a una IA controlar el editor de video Concat (importar medios, cortar, agregar títulos, exportar...).
Concat expone una API JSON-RPC 2.0 en líneas JSON sobre TCP plano (no es
WebSocket ni HTTP) en 127.0.0.1:7420. Este script traduce las herramientas MCP
a esas llamadas. Docs de la API: https://concatenate.pages.dev/docs
Requisitos
Python 3.10+
Concat abierto, con Ajustes › Remoto activado (muestra el puerto y el token)
Related MCP server: Cutible MCP Server
Instalación
pip install -r requirements.txtCopiá
.env.examplea.env.Pegá el token de Ajustes › Remoto › Token en
CONCAT_API_TOKEN. Tiene 32 caracteres hexadecimales: copialo completo.
Probar
python smoke_test.pyDebe listar las herramientas e imprimir la versión de Concat.
Usarlo con un cliente MCP
El .mcp.json de esta carpeta ya sirve para Claude Code: abrí la sesión
dentro de esta carpeta y aprobá el servidor concat. Para otros clientes
(Cursor, Claude Desktop, VS Code, Gemini CLI, Codex...) usá la misma entrada con
la ruta absoluta del script:
{
"mcpServers": {
"concat": {
"command": "python",
"args": ["C:/ruta/a/concat_test_mcp/concat_mcp.py"]
}
}
}En VS Code el archivo es .vscode/mcp.json y la clave es servers.
Herramientas
Herramienta | Qué hace |
| Versión de Concat, carpetas y capacidades |
| Llama a cualquier método de la API ( |
| Crea y abre un proyecto ( |
| Abre un proyecto existente |
| Estado del timeline: pistas, clips, medios |
| Importa un archivo; |
| Aplica una edición ( |
| Renderiza a un archivo y espera a que termine |
| Transcribe la voz con Whisper (local) y agrega los subtítulos como clips de texto, en un solo paso de undo |
Flujo típico: concat_project_create → concat_media_import →
concat_edit_apply (addClipAtFirstFree, splitClips, addTextClip...) →
concat_export. Referencia de comandos de edición:
https://concatenate.pages.dev/docs/api/edits
Subtítulos automáticos
concat_auto_subtitles(path, media_path, ...) usa faster-whisper (modelo
small por defecto; la primera vez lo descarga) en CPU. Parámetros útiles:
timeline_start: segundo del timeline donde empieza el clip.source_start/source_end: tramo del archivo a transcribir (0 = todo).language:"es","en"... (vacío = autodetectar).font_size,color,offset_y,track_id,max_chars,model.
Ejemplo: un clip que usa el tramo 25–45 s del archivo y está al inicio del
timeline → timeline_start=0, source_start=25, source_end=45. Se puede deshacer
con edit.undo. Whisper filtra los tramos sin voz (VAD), así que en música sin
canto no genera nada. El audio se decodifica con PyAV directamente porque
faster-whisper 1.2.x falla al abrir archivos con av 15 o superior.
Cosas a tener en cuenta
Rutas: la API solo escribe dentro de la carpeta de usuario (p. ej.
C:/Users/<vos>). Un proyecto enD:/es rechazado (refused). Los videos a importar sí pueden estar en cualquier lado.Barras: usá
/en las rutas dentro de los JSON.Seguridad: quien tenga el token puede leer cualquier archivo que tu usuario pueda leer, y la conexión no está cifrada. Concat escucha solo en
127.0.0.1; no lo expongas a la red. No subas.enva git.Token nuevo: si pulsás Nuevo token en Concat, actualizá
.env.
Problemas comunes
Síntoma | Causa |
| Token mal copiado (¿falta algún carácter?) o regenerado |
| La app está cerrada o Remoto está desactivado |
| Falta |
| Proyecto fuera de la carpeta de usuario |
| Paquete |
Nada funciona y hay un | Ese archivo tapa al paquete |
Licencia
AGPL-3.0-or-later, la misma que Concat. Proyecto no oficial: no está afiliado a los autores de Concat.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
The agentic video editor for ChatGPT and Claude. Ask in your chat and it cuts, captions, adds music, titles and motion graphics on a real timeline you can open and adjust.
AI video editor for agents and humans: timeline, captions, color, audio and generation as MCP tools.
AI video editor your agent can drive: plan scenes, edit a multi-track timeline, and render MP4s.
Open-source AI video editor: cut, caption, clip and animate real Revline projects from your agent.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables AI assistants to create and edit professional videos through natural language by automating JianYing (CapCut) video production workflows. Supports adding media segments, effects, transitions, animations, and exporting editable project files.20330-
- AlicenseCqualityDmaintenanceEnables AI agents to perform headless video editing through 35 tools for project creation, clip manipulation, rendering, quality control, and semantic search, all via JSON-RPC 2.0 over stdio.372MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to create, inspect and edit Kdenlive project files, import and relink media, query installed MLT effects/transitions, author subtitles, and run asynchronous MLT renders, plus drive the live Kdenlive editor UI. Edits always write new files, and rendering is job-based with verification of the output.3MIT
- AlicenseBqualityCmaintenanceProvides Claude Code with local ffmpeg-based tools to probe, trim, concat, transform, overlay, mix audio, render JSON timelines, and run automated QA on video files—no API key required.9Apache 2.0