CutPro MCP

Servidor MCP de 34 herramientas para la API v1 de CutPro: analiza videos, recorta, renderiza y publica publicaciones a través de clientes de IA como Claude, ChatGPT y Cursor.

GitHub
2
Prueba este MCPPatrocinado

Documentación

CutPro MCP

npm version MCP Registry smithery badge

Un servidor de Model Context Protocol (MCP) que convierte videos largos en clips virales con IA. Expone toda la API de CutPro como herramientas, para que un LLM pueda ejecutar el flujo completo: analizar un video, recortar los mejores momentos, renderizar el MP4 final y publicar en TikTok, Instagram y YouTube.

Características principales

  • De extremo a extremo. Los 34 endpoints v1 como herramientas: espacio de trabajo, saldo, videos, recorte, clips, plantillas, renders, publicaciones y conexiones.
  • Eficiente en tokens. Los resultados son compactos y proyectados a los campos que importan; list_clips está ordenado por calificación, limitado y omite URLs firmadas largas a menos que se soliciten.
  • Funciona en todas partes. stdio para clientes locales (Claude Code, Cursor, Claude Desktop, Windsurf, VS Code, Cline, Zed) y un endpoint Streamable HTTP alojado con OAuth para ChatGPT y Claude.ai.

Primeros pasos

Requisitos

  • Node.js 18 o superior.
  • Una cuenta de CutPro en el plan Pro y una clave de API. Genere una en cut.pro/studio/me/api-keys.
  • Un cliente compatible con MCP.

Configuración estándar

La mayoría de los clientes usan el mismo JSON. Agregue su clave de API bajo env:

{
  "mcpServers": {
    "cutpro": {
      "command": "npx",
      "args": ["-y", "@cutpro/mcp"],
      "env": { "CUTPRO_API_KEY": "<your-api-key>" }
    }
  }
}

Instalación

Install in VS Code Install in Cursor Install in LM Studio Install in Goose

Después de instalar mediante un botón, agregue su CUTPRO_API_KEY al env del servidor.

Claude Code 
claude mcp add cutpro --env CUTPRO_API_KEY=<your-api-key> -- npx -y @cutpro/mcp
Claude Desktop

Agregue a claude_desktop_config.json (Configuración, Desarrollador, Editar configuración):

{
  "mcpServers": {
    "cutpro": {
      "command": "npx",
      "args": ["-y", "@cutpro/mcp"],
      "env": { "CUTPRO_API_KEY": "<your-api-key>" }
    }
  }
}
Cursor / Windsurf / VS Code (manual)

Agregue la configuración estándar anterior a la configuración MCP del cliente (mcp.json / mcpServers).

Cline

Abra el panel de Servidores MCP, elija Configurar y agregue la configuración estándar anterior.

Gemini CLI 
gemini mcp add cutpro npx -y @cutpro/mcp -e CUTPRO_API_KEY=<your-api-key>
Codex

Agregue a ~/.codex/config.toml:

[mcp_servers.cutpro]
command = "npx"
args = ["-y", "@cutpro/mcp"]
env = { "CUTPRO_API_KEY" = "<your-api-key>" }
ChatGPT y Claude.ai (alojado, sin instalación)

Use el servidor alojado. Agregue un conector personalizado que apunte a:

https://mcp.cut.pro

Se autoriza con su clave de API de CutPro en una página de consentimiento (OAuth), por lo que no se necesita configuración local.

Configuración

El servidor se configura con variables de entorno.

VariableDescripciónRequerida
CUTPRO_API_KEYSu clave de API de CutPro (plan Pro).Sí (stdio)
CUTPRO_WORKSPACE_IDSelecciona el espacio de trabajo para claves de múltiples espacios.No
CUTPRO_API_URLSobrescribe la URL base de la API. Por defecto es https://api.cut.pro/api/v1.No
Autoalojamiento del remoto (Streamable HTTP + OAuth)
VariableDescripción
MCP_TRANSPORT=http / PORTSirve Streamable HTTP en la raíz en lugar de stdio.
MCP_OAUTH=1Habilita la capa completa de OAuth 2.1 (descubrimiento, DCR, PKCE) para clientes de navegador.
MCP_PUBLIC_URLEndpoint público, p. ej. https://mcp.cut.pro. Su origen se convierte en el emisor de OAuth.
MCP_REDIS_URLRespalda el estado de OAuth con Redis para que sobreviva reinicios y escale entre instancias.
MCP_TRANSPORT=http PORT=8787 MCP_OAUTH=1 \
MCP_PUBLIC_URL=https://mcp.cut.pro MCP_REDIS_URL=redis://127.0.0.1:6379 \
npx -y @cutpro/mcp

En modo OAuth, el usuario autoriza con su propia clave de API en una página de consentimiento; el token de acceso se asigna en el servidor a esa clave. Sin MCP_REDIS_URL, se usa un almacén en memoria (instancia única, estado perdido al reiniciar).

Herramientas

Espacio de trabajo y saldo
  • get_workspace: el espacio de trabajo al que se resolvió esta clave, con plan y rol.
  • get_balance: saldo de créditos actual.
  • get_balance_history: libro mayor de créditos agregados y consumidos.
Videos y subidas
  • list_videos: su biblioteca de videos fuente.
  • start_upload: obtenga una URL prefirmada para subir su propio archivo (máx. 2 GB; .mp4/.mov/.webm/.mkv).
  • complete_upload: registre una subida finalizada y obtenga su costo en créditos.
  • delete_video: elimine un video fuente y sus envíos.
Recorte
  • analyze_video: vista previa de metadatos y costo en créditos de una URL pública (gratis).
  • submit_clipping: inicia el recorte con IA (cobra créditos).
  • list_submissions: trabajos de recorte para un video.
  • get_submission: consulte un envío hasta que se complete o falle.
  • delete_submission: elimine un envío y sus clips.
Clips y plantillas
  • list_clips: clips de un envío completado, ordenados por calificación (URLs opcionales).
  • apply_template: aplique una plantilla de edición a clips en lote.
  • delete_clip: elimine un solo clip.
  • list_templates: plantillas de edición para aplicar a clips.
Renders
  • render_clip: renderice un clip a un MP4 final.
  • get_render: consulte un render hasta que se complete.
  • get_render_download: URL de descarga firmada de un render completado.
  • cancel_render: cancele o elimine un render.
  • get_render_limits: cuota de render para el espacio de trabajo.
  • start_bulk_download / get_bulk_download: agrupe varios renders en una sola descarga.
Publicaciones y conexiones
  • create_post: publique clips renderizados en cuentas conectadas (inmediato o programado).
  • list_posts / get_post / update_post / delete_post: administre publicaciones.
  • publish_post: active la publicación ahora.
  • retry_post_item / delete_post_item: maneje objetivos individuales.
  • list_connections / get_connection: cuentas sociales conectadas.

Cada herramienta lleva anotaciones de solo lectura / escritura / destructivas para que los clientes puedan planificar llamadas.

Enlaces

Licencia

MIT