mcp-v8

mcp-v8: V8 JavaScript MCP-Server

Ein Rust-basierter Model Context Protocol (MCP)-Server, der eine V8-JavaScript-Laufzeitumgebung als Tool für KI-Agenten wie Claude und Cursor bereitstellt. Unterstützt persistente Heap-Snapshots über S3 oder das lokale Dateisystem und ist bereit für die Integration in moderne KI-Entwicklungsumgebungen.

Merkmale

V8-JavaScript-Ausführung : Führen Sie beliebigen JavaScript-Code in einer sicheren, isolierten V8-Engine aus.
Heap-Snapshots : Behalten Sie den V8-Heap-Status zwischen den Ausführungen bei und stellen Sie ihn wieder her. Dabei werden sowohl S3 als auch lokale Dateispeicher unterstützt.
MCP-Protokoll : Implementiert das Model Context Protocol für eine nahtlose Tool-Integration mit Claude, Cursor und anderen MCP-Clients.
Konfigurierbarer Speicher : Wählen Sie zur Laufzeit zwischen S3 oder einem lokalen Verzeichnis für die Heap-Speicherung.

Installation

Installieren Sie mcp-v8 mit dem bereitgestellten Installationsskript:

curl -fsSL https://raw.githubusercontent.com/r33drichards/mcp-js/main/install.sh | sudo bash

Dadurch wird die neueste Version für Ihre Plattform automatisch heruntergeladen und in /usr/local/bin/mcp-v8 installiert (Sie werden möglicherweise zur Eingabe Ihres Kennworts aufgefordert).

Fortgeschrittene Benutzer: Wenn Sie lieber aus der Quelle erstellen möchten, lesen Sie den Abschnitt „Aus der Quelle erstellen“ am Ende dieses Dokuments.

Befehlszeilenargumente

mcp-v8 unterstützt die folgenden Befehlszeilenargumente:

--s3-bucket <bucket> : AWS S3 für Heap-Snapshots verwenden. Geben Sie den S3-Bucket-Namen an. (Konflikt mit --directory-path )
--directory-path <path> : Verwendet ein lokales Verzeichnis für Heap-Snapshots. Geben Sie den Verzeichnispfad an. (Konflikt mit --s3-bucket )

Hinweis: Sie müssen entweder --s3-bucket oder --directory-path angeben. Wenn keines von beiden angegeben wird, verwendet der Server standardmäßig S3 mit dem Bucket-Namen test-mcp-js-bucket .

Schnellstart

Nach der Installation können Sie den Server direkt ausführen. Wählen Sie eine der folgenden Optionen:

# Use S3 for heap storage (recommended for cloud/persistent use)
mcp-v8 --s3-bucket my-bucket-name

# Use local filesystem directory for heap storage (recommended for local development)
mcp-v8 --directory-path /tmp/mcp-v8-heaps

Integration

Claude für Desktop

Installieren Sie den Server wie oben.
Öffnen Sie Claude Desktop → Einstellungen → Entwickler → Konfiguration bearbeiten.
Fügen Sie Ihren Server zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "js": {
      "command": "/usr/local/bin/mcp-v8 --s3-bucket my-bucket-name"
    }
  }
}

Starten Sie Claude Desktop neu. Die neuen Tools werden unter dem Hammersymbol angezeigt.

Cursor

Installieren Sie den Server wie oben.
Erstellen oder bearbeiten Sie .cursor/mcp.json in Ihrem Projektstamm:

{
  "mcpServers": {
    "js": {
      "command": "/usr/local/bin/mcp-v8 --directory-path /tmp/mcp-v8-heaps"
    }
  }
}

Cursor neu starten. Die MCP-Tools sind in der Benutzeroberfläche verfügbar.

Beispielverwendung

Fragen Sie Claude oder Cursor: „Führen Sie dieses JavaScript aus: 1 + 2 “
Verwenden Sie Heap-Snapshots, um den Status zwischen Ausführungen beizubehalten.

Heap-Speicheroptionen

Sie können den Heap-Speicher mit den folgenden Befehlszeilenargumenten konfigurieren:

S3 : --s3-bucket <bucket>
- Beispiel: mcp-v8 --s3-bucket my-bucket-name
- Erfordert AWS-Anmeldeinformationen in Ihrer Umgebung.
Dateisystem : --directory-path <path>
- Beispiel: mcp-v8 --directory-path /tmp/mcp-v8-heaps

Hinweis: Es kann immer nur ein Speicher-Backend verwendet werden. Wenn beide angegeben werden, gibt der Server einen Fehler zurück.

Einschränkungen

Während mcp-v8 eine leistungsstarke und beständige JavaScript-Ausführungsumgebung bietet, gibt es Einschränkungen hinsichtlich der Laufzeit.

Kein async / await oder Promises : Asynchrones JavaScript wird nicht unterstützt. Der gesamte Code muss synchron sein.
Kein fetch oder Netzwerkzugriff : Es gibt keine integrierte Möglichkeit, HTTP-Anfragen zu stellen oder auf das Netzwerk zuzugreifen.
Keine console.log oder Standardausgabe : Die Ausgabe von console.log oder ähnlichen Funktionen wird nicht angezeigt. Um Ergebnisse zurückzugeben, stellen Sie sicher, dass der gewünschte Wert in der letzten Zeile Ihres Codes steht.
Kein Dateisystemzugriff : Die Laufzeitumgebung bietet keinen Zugriff auf das lokale Dateisystem oder Umgebungsvariablen.
Keine npm install oder externe Pakete : Sie können keine NPM-Pakete installieren oder importieren. Es sind nur integrierte Standard-JavaScript-Funktionen (ECMAScript) verfügbar.
Keine Timer : Funktionen wie setTimeout und setInterval sind nicht verfügbar.
Kein DOM oder Browser-APIs : Dies ist keine Browserumgebung; es gibt keinen Zugriff auf window , document oder andere browserspezifische Objekte.

Aus der Quelle erstellen (Erweitert)

Wenn Sie lieber aus der Quelle erstellen möchten, anstatt das Installationsskript zu verwenden:

Voraussetzungen

Rust (nächtliche Toolchain empfohlen)
(Optional) AWS-Anmeldeinformationen für S3-Speicher

Erstellen Sie den Server

cd server
cargo build --release

Die erstellte Binärdatei befindet sich unter server/target/release/server . Sie können diesen Pfad in den obigen Integrationsschritten bei Bedarf anstelle von /usr/local/bin/mcp-v8 verwenden.

mcp-v8

Integrations