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:
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:
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 |