MCP-Server

neru-mcp ist eine Modell-Kontext-Protokoll (MCP) Server, mit dem Ihr KI-Assistent Anwendungen veröffentlichen und auf Code-Hub ohne Ihre Chat-Oberfläche zu verlassen. Sie können Code Hub-Produkte erstellen, Quellcode hochladen, Versionen veröffentlichen und laufende VCR-Instanzen vollständig über natürlichsprachliche Anweisungen bereitstellen.

Verbindung mit dem Hosted Server

neru-mcp läuft auf VCR und ist als Remote-Endpunkt verfügbar - eine lokale Installation ist nicht erforderlich. Wählen Sie den Endpunkt, der Ihrer Region am nächsten liegt.

Region MCP-URL
EU West (Irland) https://vcr-mcp.euw1.runtime.vonage.cloud/mcp
US-Ost (Virginia) https://vcr-mcp.use1.runtime.vonage.cloud/mcp
AP Southeast (Singapur) https://vcr-mcp.apse1.runtime.vonage.cloud/mcp
AP Südost (Sydney) https://vcr-mcp.apse2.runtime.vonage.cloud/mcp

Claude Schreibtisch

Hinzufügen zu 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

Hinzufügen zu .vscode/mcp.json (oder Ihre Arbeitsbereich-MCP-Konfiguration):

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

Zu Ihrer OpenCode-Konfiguration hinzufügen:

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

Ersetzen Sie <your-api-key> und <your-api-secret> mit Ihrem Vonage API-Anmeldeinformationen). einstellen. X-Region in die Region, in der Sie die Bereitstellung vornehmen möchten.

Berechtigungsnachweise

Jedes Werkzeug akzeptiert Anmeldeinformationen entweder als HTTP-Header (empfohlen) oder als explizite Werkzeugparameter. Header haben Vorrang, wenn beide vorhanden sind.

Kopfzeile Parameter Beschreibung
X-Account-ID account_id Vonage API-Schlüssel
X-Account-Secret account_secret Vonage API-Geheimnis
X-Region region Zielregion: euw1, use1, apse1, oder apse2

Standard-Arbeitsablauf für die Bereitstellung

Sie können Ihren KI-Assistenten bitten, diesen gesamten Ablauf zu übernehmen: "Meine VCR-Anwendung auf Code Hub veröffentlichen". Der Assistent ruft jedes Tool der Reihe nach auf, fordert Sie auf, fehlende Werte einzugeben, und gibt am Ende die URL der Live-Instanz zurück.

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

Werkzeuge Referenz

marketplace_create_product

Erstellen Sie ein neues Produkt in Code-Hub.

Parameter Typ Erforderlich Standard Beschreibung
name String Ja Anzeigename (max. 200 Zeichen)
owner_name String Ja Besitzende Organisation oder Einzelperson
product_type private / public / unlisted Nein private Sichtbarkeit

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

marketplace_create_version

Erstellen Sie eine neue Version für ein bestehendes Code Hub-Produkt. Die Bereitstellung wird nach der Erstellung automatisch aktiviert.

Parameter Typ Erforderlich Standard Beschreibung
product_id UUID Ja Übergeordnetes Produkt
version semver (z.B. 1.0.0) Ja Versionsnummer
base UUID Nein Vorhandene Version als Grundlage
version_type private / public / unlisted Nein private Sichtbarkeit

Rückgabe: {"id": "<uuid>", "productId": "<uuid>"}

marketplace_upload_source

Gibt eine Proxy-URL zum Hochladen des Quellcode-Zip-Archivs zurück. POST das Zip-Archiv direkt an proxy_url - nicht base64-encodieren. Die Zip-Datei muss enthalten vcr.yml im Stammverzeichnis (nicht innerhalb eines Unterverzeichnisses).

Parameter Typ Erforderlich Standard
product_id UUID Ja
version_id UUID Ja
filename String Nein source.zip

Rückgabe: {"proxy_url": "...", "method": "POST", "field_name": "source", "instructions": "..."}

Beispiel-Upload:

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

Einreichen einer Version zur Überprüfung. Erforderlich, bevor eine Version öffentlich auf Code Hub veröffentlicht werden kann.

Parameter Typ Erforderlich
product_id UUID Ja
version_id UUID Ja

Rückgabe: {"message": "Version submitted for review"}

marketplace_release_version

Geben Sie eine genehmigte Version für Code Hub frei. Die Version muss zuvor eingereicht und genehmigt worden sein.

Parameter Typ Erforderlich
product_id UUID Ja
version_id UUID Ja

Rückgabe: {"message": "Version released to the Marketplace"}

marketplace_install_version

Installieren Sie eine freigegebene Code Hub-Produktversion als Live-VCR-Instanz.

Parameter Typ Erforderlich Standard Beschreibung
product_id UUID Ja Übergeordnetes Produkt
version_id UUID Ja Zu installierende Version
instance_name String Ja Name für die neue Instanz
product_name String Nein "" Wird zur Erstellung der Code Hub URL verwendet
configuration Objekt Nein {} Schlüssel/Wert-Konfiguration für die Instanz
secrets Array Nein [] Geheime Referenzen für die Instanz

Rückgabe: {"instance_url": "...", "codehub_url": "...", ...}

Zusätzliche Tools

Werkzeug Beschreibung
marketplace_health Prüfen Sie, ob die Code Hub API erreichbar ist
marketplace_update_product Einstellen der aktiven Version eines Code Hub-Produkts
marketplace_update_version Aktivieren oder Deaktivieren der Bereitstellung für eine Version
marketplace_upload_icon Laden Sie ein Produktsymbol hoch (PNG oder JPEG)
marketplace_upload_screenshots Produkt-Screenshots hochladen
marketplace_download_source Download des Quellarchivs für eine Version
marketplace_upgrade_instance Upgrade einer laufenden Instanz auf die neueste Version
marketplace_delete_product Dauerhaftes Löschen eines Produkts und aller seiner Versionen

Vor Ort laufen

Wenn Sie es vorziehen, den MCP-Server lokal auszuführen, anstatt die gehosteten Endpunkte zu verwenden:

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

Setzen Sie vor der Ausführung die folgenden Umgebungsvariablen:

Variabel Beschreibung
API_ACCOUNT_ID Vonage API-Schlüssel
API_ACCOUNT_SECRET Vonage API-Geheimnis
REGION Zielregion (euw1, use1, apse1, apse2)
MCP_TRANSPORT Transportmodus: stdio (Voreinstellung), sse, oder streamable-http