Servidor MCP

neru-mcp es un Protocolo de Contexto Modelo (MCP) que permite a su asistente de IA publicar e implantar aplicaciones en Código Hub sin salir de su interfaz de chat. Puede crear productos Code Hub, cargar código fuente, publicar versiones y desplegar instancias VCR en ejecución totalmente a través de instrucciones en lenguaje natural.

Conectarse al servidor alojado

neru-mcp se ejecuta en VCR y está disponible como punto final remoto: no requiere instalación local. Elija el punto final más cercano a su región.

Región URL MCP
UE Oeste (Irlanda) https://vcr-mcp.euw1.runtime.vonage.cloud/mcp
Este de EE.UU. (Virginia) https://vcr-mcp.use1.runtime.vonage.cloud/mcp
AP Sudeste (Singapur) https://vcr-mcp.apse1.runtime.vonage.cloud/mcp
AP Sureste (Sydney) https://vcr-mcp.apse2.runtime.vonage.cloud/mcp

Claude Escritorio

Añadir a claude_desktop_config.json:

{
  "mcpServers": {
    "neru-mcp": {
      "type": "http",
      "url": "https://vcr-mcp.euw1.runtime.vonage.cloud/mcp",
      "headers": {
        "X-Account-ID": "<your-api-key>",
        "X-Account-Secret": "<your-api-secret>",
        "X-Region": "euw1"
      }
    }
  }
}

VS Code / GitHub Copilot

Añadir a .vscode/mcp.json (o la configuración MCP de su espacio de trabajo):

{
  "servers": {
    "neru-mcp": {
      "type": "http",
      "url": "https://vcr-mcp.euw1.runtime.vonage.cloud/mcp",
      "headers": {
        "X-Account-ID": "<your-api-key>",
        "X-Account-Secret": "<your-api-secret>",
        "X-Region": "euw1"
      }
    }
  }
}

OpenCode

Añádelo a tu configuración OpenCode:

{
  "mcp": {
    "neru-mcp": {
      "type": "remote",
      "url": "https://vcr-mcp.euw1.runtime.vonage.cloud/mcp",
      "enabled": true,
      "headers": {
        "X-Account-ID": "<your-api-key>",
        "X-Account-Secret": "<your-api-secret>",
        "X-Region": "euw1"
      }
    }
  }
}

Sustituir <your-api-key> y <your-api-secret> con su Credenciales de API de Vonage). Configure X-Region a la región en la que desea desplegar.

Credenciales

Todas las herramientas aceptan credenciales como cabeceras HTTP (recomendado) o como parámetros explícitos de la herramienta. Las cabeceras tienen preferencia cuando ambas están presentes.

Cabecera Parámetro Descripción
X-Account-ID account_id Clave API de Vonage
X-Account-Secret account_secret Secreto de API de Vonage
X-Region region Región objetivo: euw1, use1, apse1o apse2

Flujo de trabajo de implantación estándar

Puedes pedirle a tu asistente de IA que ejecute todo este flujo: "Publicar mi aplicación VCR en Code Hub". El asistente llamará a cada herramienta en orden, le pedirá los valores que falten y le devolverá la URL de la instancia activa al final.

Create Code Hub product
        |
Create product version
        |
Upload source code  (POST zip to returned proxy_url)
        |
Submit version for review
        |
Release version
        |
Install as VCR instance

Herramientas Referencia

marketplace_create_product

Crear un nuevo producto en Código Hub.

Parámetro Tipo Requerido Por defecto Descripción
name cadena Nombre para mostrar (máx. 200 caracteres)
owner_name cadena Organización o individuo propietario
product_type private / public / unlisted No private Visibilidad

Devoluciones: {"id": "<uuid>", "codehub_url": "https://developer.vonage.com/..."}

marketplace_create_version

Cree una nueva versión para un producto Code Hub existente. El despliegue se activa automáticamente tras la creación.

Parámetro Tipo Requerido Por defecto Descripción
product_id UUID Producto principal
version semver (por ejemplo 1.0.0) Número de versión
base UUID No Versión existente en la que basarse
version_type private / public / unlisted No private Visibilidad

Devoluciones: {"id": "<uuid>", "productId": "<uuid>"}

marketplace_upload_source

Devuelve una URL proxy para subir el archivo zip del código fuente. Envíe el zip directamente a proxy_url - no lo codifiques en base64. El zip debe contener vcr.yml en su raíz (no dentro de un subdirectorio).

Parámetro Tipo Requerido Por defecto
product_id UUID
version_id UUID
filename cadena No source.zip

Devoluciones: {"proxy_url": "...", "method": "POST", "field_name": "source", "instructions": "..."}

Ejemplo de carga:

curl -X POST "<proxy_url>" \ -H "X-Account-ID: <key>" \ -H "X-Account-Secret: <secret>" \ -H "X-Region: euw1" \ -F "source=@/path/to/source.zip"

marketplace_submit_version

Enviar una versión para su revisión. Es necesario para publicar una versión en Code Hub.

Parámetro Tipo Requerido
product_id UUID
version_id UUID

Devoluciones: {"message": "Version submitted for review"}

marketplace_release_version

Publique una versión aprobada en Code Hub. La versión debe haber sido enviada y aprobada primero.

Parámetro Tipo Requerido
product_id UUID
version_id UUID

Devoluciones: {"message": "Version released to the Marketplace"}

marketplace_install_version

Instale una versión liberada del producto Code Hub como una instancia VCR activa.

Parámetro Tipo Requerido Por defecto Descripción
product_id UUID Producto principal
version_id UUID Versión a instalar
instance_name cadena Nombre de la nueva instancia
product_name cadena No "" Se utiliza para construir la URL de Code Hub
configuration objeto No {} Configuración clave/valor para la instancia
secrets matriz No [] Referencias secretas de la instancia

Devoluciones: {"instance_url": "...", "codehub_url": "...", ...}

Herramientas adicionales

Herramienta Descripción
marketplace_health Compruebe que se puede acceder a la API de Code Hub
marketplace_update_product Establecer la versión activa de un producto Code Hub
marketplace_update_version Activar o desactivar el despliegue de una versión
marketplace_upload_icon Cargar un icono de producto (PNG o JPEG)
marketplace_upload_screenshots Subir capturas de pantalla de productos
marketplace_download_source Descargar el archivo fuente de una versión
marketplace_upgrade_instance Actualizar una instancia en ejecución a la última versión
marketplace_delete_product Eliminar permanentemente un producto y todas sus versiones

Ejecutar localmente

Si prefiere ejecutar el servidor MCP localmente en lugar de utilizar los puntos finales alojados:

uvx --from git+https://github.com/nexmoinc/neru-mcp.git neru-mcp

Establezca las siguientes variables de entorno antes de ejecutar:

Variable Descripción
API_ACCOUNT_ID Clave API de Vonage
API_ACCOUNT_SECRET Secreto de API de Vonage
REGION Región objetivo (euw1, use1, apse1, apse2)
MCP_TRANSPORT Modo de transporte: stdio (por defecto), sseo streamable-http