Serveur MCP

neru-mcp est un Protocole de contexte de modèle (MCP) serveur qui permet à votre assistant d'IA de publier et de déployer des applications sur le site de l'entreprise. Hub de code sans quitter votre interface de chat. Vous pouvez créer des produits Code Hub, télécharger du code source, publier des versions et déployer des instances de VCR en cours d'exécution entièrement à l'aide d'instructions en langage naturel.

Connexion au serveur hébergé

neru-mcp fonctionne sur un magnétoscope et est disponible en tant que point d'extrémité distant - aucune installation locale n'est nécessaire. Choisissez le point d'accès le plus proche de votre région.

Région URL DU PCM
UE Ouest (Irlande) https://vcr-mcp.euw1.runtime.vonage.cloud/mcp
Est des États-Unis (Virginie) https://vcr-mcp.use1.runtime.vonage.cloud/mcp
AP Sud-Est (Singapour) https://vcr-mcp.apse1.runtime.vonage.cloud/mcp
AP Southeast (Sydney) https://vcr-mcp.apse2.runtime.vonage.cloud/mcp

Bureau de Claude

Ajouter à la liste 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

Ajouter à la liste .vscode/mcp.json (ou la configuration MCP de votre espace de travail) :

{
  "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

Ajouter à votre configuration 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"
      }
    }
  }
}

Remplacer <your-api-key> et <your-api-secret> avec votre Identifiants API de Vonage). Fixer X-Region dans la région où vous souhaitez effectuer le déploiement.

Titres de compétences

Chaque outil accepte les informations d'identification soit sous forme d'en-têtes HTTP (recommandé), soit sous forme de paramètres explicites de l'outil. Les en-têtes sont prioritaires lorsque les deux sont présents.

En-tête Paramètres Description
X-Account-ID account_id Clé API Vonage
X-Account-Secret account_secret Secret de l'API Vonage
X-Region region Région cible : euw1, use1, apse1ou apse2

Processus de déploiement standard

Vous pouvez demander à votre assistant IA de gérer l'ensemble de ce flux : "Publier mon application VCR sur Code Hub".. L'assistant appellera chaque outil dans l'ordre, vous demandera d'indiquer les valeurs manquantes et vous renverra l'URL de l'instance en direct à la fin.

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

Référence des outils

marketplace_create_product

Créer un nouveau produit dans Hub de code.

Paramètres Type Exigée Défaut Description
name chaîne de caractères Oui Nom d'affichage (200 caractères maximum)
owner_name chaîne de caractères Oui Organisation ou individu propriétaire
product_type private / public / unlisted Non private Visibilité

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

marketplace_create_version

Créer une nouvelle version pour un produit Code Hub existant. Le déploiement est activé automatiquement après la création.

Paramètres Type Exigée Défaut Description
product_id UUID Oui Produit parent
version semver (par exemple 1.0.0) Oui Numéro de version
base UUID Non Version existante sur laquelle se baser
version_type private / public / unlisted Non private Visibilité

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

marketplace_upload_source

Renvoie une URL proxy pour télécharger l'archive zip du code source. POST le zip directement à proxy_url - ne pas l'encoder en base64. Le fichier zip doit contenir vcr.yml à sa racine (et non dans un sous-répertoire).

Paramètres Type Exigée Défaut
product_id UUID Oui
version_id UUID Oui
filename chaîne de caractères Non source.zip

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

Exemple de téléchargement :

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

Soumettre une version pour examen. Nécessaire pour qu'une version puisse être publiée publiquement sur Code Hub.

Paramètres Type Exigée
product_id UUID Oui
version_id UUID Oui

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

marketplace_release_version

Publier une version approuvée dans Code Hub. La version doit d'abord avoir été soumise et approuvée.

Paramètres Type Exigée
product_id UUID Oui
version_id UUID Oui

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

marketplace_install_version

Installer une version publiée du produit Code Hub en tant qu'instance de VCR.

Paramètres Type Exigée Défaut Description
product_id UUID Oui Produit parent
version_id UUID Oui Version à installer
instance_name chaîne de caractères Oui Nom de la nouvelle instance
product_name chaîne de caractères Non "" Utilisé pour construire l'URL de Code Hub
configuration objet Non {} Configuration clé/valeur pour l'instance
secrets réseau Non [] Références secrètes de l'instance

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

Outils supplémentaires

Outil Description
marketplace_health Vérifier que l'API Code Hub est accessible
marketplace_update_product Définir la version active d'un produit Code Hub
marketplace_update_version Activer ou désactiver le déploiement pour une version
marketplace_upload_icon Télécharger une icône de produit (PNG ou JPEG)
marketplace_upload_screenshots Télécharger des captures d'écran de produits
marketplace_download_source Télécharger l'archive source d'une version
marketplace_upgrade_instance Mettre à jour une instance en cours d'exécution vers la dernière version
marketplace_delete_product Supprimer définitivement un produit et toutes ses versions

Exécuter localement

Si vous préférez exécuter le serveur MCP localement au lieu d'utiliser les points de terminaison hébergés :

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

Définissez les variables d'environnement suivantes avant d'exécuter le programme :

Variable Description
API_ACCOUNT_ID Clé API Vonage
API_ACCOUNT_SECRET Secret de l'API Vonage
REGION Région cible (euw1, use1, apse1, apse2)
MCP_TRANSPORT Mode de transport : stdio (par défaut), sseou streamable-http