@avclabs.ai/enhance-mcp (Node.js)

中文文档 | Inglés

Un servicio de mejora de vídeo basado en el protocolo MCP, que actúa como cliente-servidor MCP para interactuar con un servidor HTTP FastAPI.

Características

Se proporcionan las siguientes herramientas MCP:

• create_task - Crear una tarea de mejora de vídeo (admite URL o carga de archivo local)

• get_task_status - Consultar el estado de la tarea

• enhance_video_sync - Mejorar un vídeo de forma síncrona (espera bloqueante)

Instalación

Instalar desde npm (Recomendado)

npm install -g @avclabs.ai/enhance-mcp

O utilice yarn/pnpm:

yarn global add @avclabs.ai/enhance-mcp
pnpm add -g @avclabs.ai/enhance-mcp

Instalar desde el código fuente

git clone https://github.com/avclabs/enhance-mcp.git
cd js_client
npm install
npm run build

Uso

1. Línea de comandos

Utilícelo directamente después de la instalación global:

avclabs-enhance-mcp --base-url https://mcp.avc.ai --api-key your-api-key

O utilice variables de entorno:

# Windows PowerShell
$env:HTTP_API_BASE_URL="https://mcp.avc.ai"
$env:HTTP_API_KEY="your-api-key"
avclabs-enhance-mcp

# Windows CMD
set HTTP_API_BASE_URL=https://mcp.avc.ai
set HTTP_API_KEY=your-api-key
avclabs-enhance-mcp

# macOS/Linux
export HTTP_API_BASE_URL=https://mcp.avc.ai
export HTTP_API_KEY=your-api-key
avclabs-enhance-mcp

2. Configurar en Claude Desktop

Edite el archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "video-enhancement": {
      "command": "avclabs-enhance-mcp",
      "args": [
        "--base-url",
        "https://mcp.avc.ai",
        "--api-key",
        "your-api-key"
      ]
    }
  }
}

3. Usar con npx (No requiere instalación global)

npx @avclabs.ai/enhance-mcp --base-url https://mcp.avc.ai --api-key your-api-key

Configuración de Claude Desktop:

{
  "mcpServers": {
    "video-enhancement": {
      "command": "npx",
      "args": [
        "@avclabs.ai/enhance-mcp",
        "--base-url",
        "https://mcp.avc.ai",
        "--api-key",
        "your-api-key"
      ]
    }
  }
}

Herramientas proporcionadas

create_task

Crear una tarea de mejora de vídeo (asíncrona).

Parámetros:

• video_source (string, requerido): URL del vídeo o ruta del archivo local

• type (string, opcional): Tipo de carga, por defecto es "url"

  • Opciones: "url" - URL de vídeo de red, "local" - Ruta de archivo local

• resolution (string, opcional): Resolución objetivo, por defecto es 720p

  • Opciones: 480p, 540p, 720p, 1080p, 2k

Ejemplo:

// URL mode
{
  "video_source": "https://example.com/video.mp4",
  "type": "url",
  "resolution": "1080p"
}

// Local file mode
{
  "video_source": "/path/to/local/video.mp4",
  "type": "local",
  "resolution": "1080p"
}

Retorno:

{
  "success": true,
  "task_id": "xxx",
  "status": "wait"
}

get_task_status

Consultar el estado de la tarea.

Parámetros:

• task_id (string, requerido): ID de la tarea

Ejemplo:

{
  "task_id": "task-123-abc"
}

Retorno:

{
  "success": true,
  "task_id": "xxx",
  "status": "completed",
  "progress": 100,
  "video_url": "https://...",
  "error_message": null,
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-01T00:01:00Z"
}

enhance_video_sync

Mejorar un vídeo de forma síncrona (espera bloqueante hasta completar).

Parámetros:

• video_source (string, requerido): URL del vídeo o ruta del archivo local

• type (string, opcional): Tipo de carga, por defecto es "url"

  • Opciones: "url" - URL de vídeo de red, "local" - Ruta de archivo local

• resolution (string, opcional): Resolución objetivo, por defecto es 720p

• poll_interval (number, opcional): Intervalo de sondeo en segundos, por defecto es 5

• timeout (number, opcional): Tiempo de espera en segundos, por defecto es 600

Ejemplo:

{
  "video_source": "https://example.com/video.mp4",
  "type": "url",
  "resolution": "1080p",
  "poll_interval": 5,
  "timeout": 600
}

Retorno:

{
  "success": true,
  "task_id": "xxx",
  "status": "completed",
  "progress": 100,
  "video_url": "https://..."
}

Notas sobre la carga de archivos

Cuando type se establece en "local", el servidor MCP hará lo siguiente:

1. Leerá el archivo local

2. Codificará el archivo en base64

3. Lo subirá al servicio de mejora de vídeo

Limitaciones:

• Tamaño máximo de archivo: 100MB

Variables de entorno

Desarrollo

# Clone the repository
git clone https://github.com/avclabs/enhance-mcp.git
cd js_client

# Install dependencies
npm install

# Development mode (auto-compile)
npm run dev

# Build
npm run build

Licencia

Licencia MIT - Consulte el archivo LICENSE para más detalles.