BlazeSQL MCP Server

BlazeSQL MCP-Server

Dieses Projekt implementiert einen Model Context Protocol (MCP)-Server, der als Proxy für die BlazeSQL Natural Language Query API fungiert. Es ermöglicht MCP-kompatiblen Clients (wie Cursor, Claude 3 mit Tool-Nutzung, dem MCP Inspector usw.) die Interaktion mit BlazeSQL in natürlicher Sprache.

Merkmale

• Stellt die BlazeSQL Natural Language Query API als MCP-Tool namens blazesql_query bereit.
• Behandelt die API-Schlüsselauthentifizierung sicher über Umgebungsvariablen.
• Kommuniziert mit Clients über den standardmäßigen MCP-Stdio-Transport.

Workflow-Diagramm

Dieses Diagramm zeigt die Abfolge der Interaktionen, wenn ein Client das Tool blazesql_query verwendet:

Voraussetzungen

• Node.js (LTS-Version empfohlen)
• Garn (Klassisch oder Beere)
• Ein BlazeSQL-Konto mit einem API-Schlüssel (für die API ist ein Team Advanced-Abonnement erforderlich).
• Mindestens eine Datenbankverbindung ist in Ihrem BlazeSQL-Konto konfiguriert.
• BlazeSQL Natural Language Query API-Dokumentation: https://help.blazesql.com/en/article/natural-language-query-api-1fgx4au/

Aufstellen

1. Klonen Sie das Repository:
   git clone <repository-url> cd blaze-sql-mcp-server
2. Abhängigkeiten installieren:
   yarn install
3. Umgebungsvariablen konfigurieren:
   • Kopieren Sie die Beispielumgebungsdatei:
     cp .env.sample .env
   • Bearbeiten Sie die .env Datei:
     # .env BLAZE_API_KEY=YOUR_BLAZESQL_API_KEY_HERE
     Ersetzen Sie YOUR_BLAZESQL_API_KEY_HERE durch Ihren tatsächlichen API-Schlüssel, den Sie aus Ihren BlazeSQL-Kontoeinstellungen erhalten haben.

Ausführen des Servers

1. Erstellen Sie den Server: Kompilieren Sie den TypeScript-Code in JavaScript:
   yarn build
2. Führen Sie den Server aus: Führen Sie den kompilierten Code aus:
   node build/index.js
   Der Server startet und protokolliert Meldungen in stderr (möglicherweise wird „API-Schlüssel erfolgreich geladen …“ usw. angezeigt). Er wartet nun über die Standard-Ein-/Ausgabe (stdio) auf eine MCP-Clientverbindung.

Verbinden eines MCP-Clients

Dieser Server verwendet den stdio- Transportmechanismus.

Verwenden des MCP Inspector (zum Testen empfohlen)

1. Stellen Sie sicher, dass der Server nicht bereits separat ausgeführt wird.
2. Führen Sie den Inspector aus und weisen Sie ihn an, Ihren Server zu starten:
   npx @modelcontextprotocol/inspector node build/index.js
3. Die Inspector-Benutzeroberfläche wird gestartet und stellt automatisch eine Verbindung zu Ihrem Server her.
4. Navigieren Sie zur Registerkarte „Tools“, um mit dem Tool blazesql_query zu interagieren.

Verwendung integrierter Clients (Cursor, Claude 3 usw.)

1. Starten Sie den Server in einem Terminal:
   node build/index.js
2. Konfigurieren Sie den Client: In den Einstellungen Ihres MCP-Clients müssen Sie eine benutzerdefinierte Serverkonfiguration hinzufügen.
   • Transport: Wählen Sie stdio aus.
   • Befehl: Geben Sie den genauen Befehl zum Ausführen des Servers an. Sie müssen den absoluten Pfad zum Knoten und den absoluten Pfad zur Datei build/index.js angeben.
     • Beispiel (macOS/Linux – Pfade nach Bedarf anpassen): /usr/local/bin/node /Users/your_username/path/to/blaze-sql-mcp-server/build/index.js
     • Sie können den Pfad zum Knoten mithilfe der Angabe which node in Ihrem Terminal finden.
     • Den Pfad zum Projekt finden Sie mit pwd im Projektverzeichnis.
   • Speichern Sie die Konfiguration.
3. Der Client sollte jetzt in der Lage sein, eine Verbindung zu Ihrem lokal laufenden Server herzustellen und dessen Tools aufzulisten/verwenden.

Verwenden des blazesql_query -Tools

Sobald die Verbindung hergestellt ist, kann der Client das Tool blazesql_query aufrufen.

• Toolname: blazesql_query
• Argumente:
  • db_id (Zeichenfolge, erforderlich): Die ID der Zieldatenbankverbindung in Ihrem BlazeSQL-Konto. Sie finden diese ID in der BlazeSQL-Webanwendung beim Verwalten Ihrer Datenbankverbindungen.
  • natural_language_request (Zeichenfolge, erforderlich): Die Abfrage, die Sie ausführen möchten, in einfachem Englisch geschrieben (z. B. „Zeigen Sie mir die Gesamtzahl der Benutzer“).
• Beispielaufruf (zur Veranschaulichung wird mcp test verwendet):
  call-tool blazesql_query --db_id "db_your_actual_db_id" --natural_language_request "What were the total sales last month?"
• Ausgabe: Bei Erfolg gibt das Tool Folgendes zurück:
  • Ein text , der die Antwort des BlazeSQL-Agenten in natürlicher Sprache enthält.
  • Ein code (Sprache sql ), der die von BlazeSQL generierte und ausgeführte SQL-Abfrage enthält.
  • Aus der Abfrage ergibt sich ein json -Block mit den eigentlichen Daten. Bei einem Misserfolg wird eine MCP-Fehlermeldung zurückgegeben.