Einrichtungsanleitung: Fullscale Rocks MCP-Server

Diese Anleitung erklärt, wie man den MCP-Server für die fullscale-rocks-Datenbank installiert, konfiguriert und startet.

1. Installation

Falls noch nicht geschehen, installieren Sie die Abhängigkeiten:

cd rocks-mcp
npm install

2. Konfiguration

Der Server benötigt Datenbank-Anmeldedaten und einen öffentlichen OAuth-Schlüssel.

Datenbankeinstellungen

Erstellen oder bearbeiten Sie rocks-mcp/.env:

MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
MYSQL_DATABASE=employee
MYSQL_USER=employee
MYSQL_PASSWORD=thisisapassword

PG_HOST=127.0.0.1
PG_PORT=5432
PG_DATABASE=employee
PG_USER=employee
PG_PASSWORD=thisisapassword

SSE_PORT=3001

Authentifizierung

Der Server sucht automatisch nach dem öffentlichen OAuth-Schlüssel unter: /home/ryscript/fullscale-rocks/rocks-api/storage/oauth-public.key

Stellen Sie sicher, dass diese Datei existiert, da sie zur Überprüfung von JWT-Tokens von rocks-api verwendet wird.

3. Ausführen des Servers

Entwicklungsmodus

Startet den Server mit tsx (lädt bei Dateiänderungen neu):

npm run dev

Produktionsmodus

Kompilieren Sie den TypeScript-Code und starten Sie die erstellte Version:

npm run build
npm start

4. Verbindung zu KI-Anwendungen

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "rocks-db": {
      "command": "node",
      "args": ["/home/ryscript/fullscale-rocks/rocks-mcp/build/index.js"]
    }
  }
}

Generischer MCP-Client (SSE)

Der Server unterstützt auch Server-Sent Events (SSE) für Remote- oder webbasierte Clients.

• SSE-URL: http://localhost:3001/sse

• Post-Message-URL: http://localhost:3001/message

Sie können dies mit dem MCP Inspector oder anderen SSE-kompatiblen Clients verwenden.

5. Referenz der Tools

Der Server stellt die folgenden Tools bereit:

Hinweis: Das auth_token sollte ein gültiges Bearer-Token sein, das über den Anmeldeprozess von rocks-api erhalten wurde.