RawTree MCP Server

Ein MCP-Server für RawTree, eine Analysedatenbank für unstrukturierte Daten. Daten mit SQL abfragen, JSON einfügen, Tabellenschemata prüfen, RawTree-Protokolle einsehen und Datenbankanmeldeinformationen von MCP-Clients wie Claude Code, Cursor und Claude Desktop aus verwalten.

Funktionen

• Abfragen — Schreibgeschütztes SQL gegen eine RawTree-Datenbank ausführen und JSON-Zeilen, Metadaten, Statistiken und Hinweise empfangen.

• Erfassen — Ein einzelnes JSON-Objekt, Arrays von JSON-Objekten oder Daten von öffentlichen URLs einfügen. Unterstützt integrierte RawTree-Transformationen für OTLP-Traces/Logs/Metriken, CloudWatch Logs, CloudTrail und Firehose.

• Tabellen — Tabellen auflisten, Tabellenspalten und -größen beschreiben und Tabellen nach expliziter Bestätigung löschen.

• Protokolle — RawTree-Abfrage- und Einfügeverlauf mit strukturierten Filtern für Typ, Status, Herkunft, Tabelle, Hinweise, Zeitfenster und Paginierung prüfen.

• API-Schlüssel — RawTree-API-Schlüssel für eine Datenbank auflisten, erstellen und widerrufen. Erstellungsantworten enthalten den einmaligen API-Schlüsselwert.

• Organisationen — Organisationen auflisten, die für einen OAuth-authentifizierten Benutzer verfügbar sind.

• Datenbanken — Datenbanken in einem Cluster auflisten und den Zugriff auf eine ausgewählte Datenbank verifizieren.

• Cluster — Dedizierte Cluster auflisten und einen Cluster nach expliziter Bestätigung bereitstellen. RawTree erzwingt die Autorisierung von Benutzer und Organisationsadministrator.

• Transports — Unterstützt stdio für lokale MCP-Clients und Streamable HTTP für Remote- oder Multi-Client-Bereitstellungen, einschließlich zustandsloser MCP 2026-07-28-Anfragen und Legacy-Clients mit initialize-Handshake.

Related MCP server: Chakra MCP Server

Einrichtung

Erstellen Sie einen RawTree-API-Schlüssel über die RawTree-CLI, das Dashboard oder die API. Ein Datenbank-API-Schlüssel beginnt mit rt_ und reicht für Datentools wie run-query, insert-json, list-tables und list-logs aus.

Das Tool get_database verwendet den aktuellen API-Schlüssel, um die Datenbankidentität über den RawTree-Schlüssel-Endpunkt zu lesen, mit einem Tabellen-Endpunkt als Fallback für nicht-administrative, lesefähige Datenbank-API-Schlüssel.

Verwendung

Der Server unterstützt zwei Transportmodi: stdio (Standard) und HTTP.

Stdio-Transport

Schnelleinrichtung

npx add-mcp @rawtree/mcp --name rawtree --env "RAWTREE_API_KEY=rt_xxxxxxxxx"

Claude Code

claude mcp add rawtree -e RAWTREE_API_KEY=rt_xxxxxxxxx -- npx -y @rawtree/mcp

Cursor

Öffnen Sie die Befehlspalette und wählen Sie „Cursor Settings" > „MCP" > „Add new global MCP server".

{
  "mcpServers": {
    "rawtree": {
      "command": "npx",
      "args": ["-y", "@rawtree/mcp"],
      "env": {
        "RAWTREE_API_KEY": "rt_xxxxxxxxx"
      }
    }
  }
}

Claude Desktop

Öffnen Sie die Claude-Desktop-Einstellungen > Registerkarte „Developer" > „Edit Config".

{
  "mcpServers": {
    "rawtree": {
      "command": "npx",
      "args": ["-y", "@rawtree/mcp"],
      "env": {
        "RAWTREE_API_KEY": "rt_xxxxxxxxx"
      }
    }
  }
}

HTTP-Transport

Führen Sie den Server über HTTP für Remote- oder webbasierte Integrationen aus. Im HTTP-Modus authentifiziert sich jeder MCP-Client, indem er seinen RawTree-API-Schlüssel im Authorization-Header übergibt.

Starten Sie den Server:

npx -y @rawtree/mcp --http --port 3000

Der Server lauscht auf http://127.0.0.1:3000 und stellt den MCP-Endpunkt unter /mcp über Streamable HTTP bereit.

Claude Code

claude mcp add rawtree --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer rt_xxxxxxxxx"

Cursor

{
  "mcpServers": {
    "rawtree": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer rt_xxxxxxxxx"
      }
    }
  }
}

Sie können den Port auch über die Umgebungsvariable MCP_PORT festlegen:

MCP_PORT=3000 npx -y @rawtree/mcp --http

Optionen

• --api-key: RawTree-Datenbank-API-Schlüssel für den stdio-Modus

• --api-url: RawTree-API-Basis-URL, Standard https://api.rawtree.com

• --database: Datenbankname für bereichsbezogene Routen

• --org: Organisationsname für bereichsbezogene Routen

• --http: HTTP-Transport anstelle von stdio verwenden

• --port: HTTP-Port bei Verwendung von --http, Standard 3000 oder MCP_PORT

Umgebungsvariablen:

• RAWTREE_API_KEY: RawTree-Datenbank-API-Schlüssel

• RAWTREE_API_URL: RawTree-API-Basis-URL, Standard https://api.rawtree.com

• RAWTREE_DATABASE: Datenbankname für bereichsbezogene Routen

• RAWTREE_ORG: Organisationsname für bereichsbezogene Routen

• MCP_PORT: HTTP-Port bei Verwendung von --http

Tools

Daten

• check-health — Prüfen, ob der RawTree-API-Endpunkt erreichbar ist.

• run-query — Schreibgeschütztes SQL ausführen und die JSON-Abfrageantwort von RawTree zurückgeben. Akzeptiert Überschreibungen für Organisation, Cluster und Datenbank.

• insert-json — JSON-Objekt(e) in eine Tabelle einfügen, optional mit einer RawTree-Transformation.

• insert-from-url — Daten von einer öffentlichen URL erfassen und den NDJSON-Fortschrittsstream von RawTree zurückgeben.

Tabellen

• list-tables — Tabellen in der konfigurierten Datenbank auflisten.

• describe-table — Spalten, Zeilenanzahl, Byteanzahl, Datenbank und Organisation prüfen.

• delete-table — Eine Tabelle nach expliziter Bestätigung löschen. Erfordert Administratorberechtigung.

Protokolle

• list-logs — RawTree-Abfrage- und Einfügeprotokolle lesen. Standardmäßig die letzte Stunde, wenn kein Zeitfenster angegeben ist.

Strukturierte Protokollfilter umfassen:

{
  "statuses": ["error"],
  "types": ["insert"],
  "tables": ["events"],
  "origins": ["api"],
  "hints": "any",
  "limit": 50
}

API-Schlüssel

• list-api-keys — API-Schlüssel für die konfigurierte Datenbank auflisten.

• create-api-key — Einen Schlüssel mit der Berechtigung admin, read_write, write_only oder read_only erstellen.

• delete-api-key — Einen Schlüssel nach expliziter Bestätigung widerrufen.

Datenbanken

• list-databases — Datenbanken in einer Organisation und einem Cluster auflisten.

• get_database — Eine ausgewählte Datenbank verifizieren und { "name": "...", "organization": { "name": "..." } } zurückgeben.

Organisationen

• list-organizations — Organisationen auflisten, die für den authentifizierten Benutzer verfügbar sind. Erfordert eine Benutzeranmeldeinformation wie OAuth.

Cluster

• list-clusters — Dedizierte Cluster auflisten, die in einer Organisation zugänglich sind.

• create-cluster — Einen dedizierten Cluster nach expliziter Bestätigung seiner Organisation und abrechenbaren Ressourcenkonfiguration bereitstellen.

Cluster-Tools werden jedem MCP-Client angekündigt. Die RawTree-API bleibt die Autorisierungsgrenze: Der Clusterzugriff erfordert ein Benutzerzugriffstoken, und die Clustererstellung erfordert zusätzlich Organisationsadministratorzugriff.

Programmatische gehostete Bereitstellungen können eine explizite Ressourcenauswahl für jedes anwendbare Tool erfordern. Organisation und Cluster identifizieren die Ressourcengrenze; die Datenbank bleibt eine optionale Überschreibung und standardmäßig auf default, wenn sie weggelassen wird. Dadurch kann eine einzelne OAuth-unterstützte MCP-Verbindung zwischen Organisationen, Clustern und Datenbanken wechseln, ohne den Kontext in der MCP-URL zu kodieren:

const server = createMcpServer(client, { requireExplicitScope: true });

Beispiele

Abfrage

{
  "organization": "acme",
  "cluster": "production",
  "database": "analytics",
  "sql": "SELECT count() AS rows FROM events"
}

JSON einfügen

{
  "table": "events",
  "data": [
    {
      "event": "signup",
      "user_id": "user_123",
      "source": "mcp"
    }
  ]
}

OTLP-Traces einfügen

{
  "table": "traces",
  "transform": "otlp-traces",
  "data": {
    "resource": {
      "attributes": [
        {
          "key": "service.name",
          "value": {
            "stringValue": "api"
          }
        }
      ]
    },
    "scopeSpans": [
      {
        "spans": [
          {
            "name": "GET /health",
            "spanId": "abc"
          }
        ]
      }
    ]
  }
}

Fehlgeschlagene Einfügungen debuggen

{
  "statuses": ["error"],
  "types": ["insert"],
  "startTime": "2026-05-28T09:00:00.000Z",
  "endTime": "2026-05-28T10:00:00.000Z",
  "limit": 25
}

Lokale Entwicklung

1. Installieren und erstellen:

pnpm install
pnpm build

2. Verwenden Sie den lokalen Build von einem MCP-Client:

claude mcp add rawtree -e RAWTREE_API_KEY=rt_xxxxxxxxx -- node /absolute/path/to/rawtree-mcp/dist/index.js

Live-Tests mit einem MCP-Client

Führen Sie TypeScript im Watch-Modus aus und richten Sie dann einen separaten MCP-Client auf den erstellten Server:

pnpm tsc --watch

{
  "mcpServers": {
    "rawtree-dev": {
      "command": "node",
      "args": ["/absolute/path/to/rawtree-mcp/dist/index.js"],
      "env": {
        "RAWTREE_API_KEY": "rt_xxxxxxxxx"
      }
    }
  }
}

Starten Sie die MCP-Client-Sitzung nach jedem Neubuild neu.

Programmatische Verwendung

Das Paket-Root stellt die wiederverwendbare MCP-Server-Schicht bereit. Der Node-HTTP-Transport ist separat von @rawtree/mcp/http verfügbar, sodass gehostete Adapter die Server-Factory verwenden können, ohne den lokalen Prozess-Einstiegspunkt zu importieren.

import { createMcpServer, RawTreeClient } from '@rawtree/mcp';

const client = new RawTreeClient({ apiKey: process.env.RAWTREE_API_KEY! });
const server = createMcpServer(client);

Veröffentlichung

Die Veröffentlichung wird vom GitHub-Actions-Workflow Publish übernommen.

Erforderliches Repository-Geheimnis:

• NPM_TOKEN: npm-Automatisierungstoken mit der Berechtigung, @rawtree/mcp zu veröffentlichen.

Release-Ablauf:

1. Aktualisieren Sie package.json auf die neue Version.

2. Übertragen Sie die Änderung an main.

3. Erstellen und veröffentlichen Sie ein GitHub-Release mit einem Tag, das der Paketversion entspricht, z. B. v0.2.0.

Der Workflow überprüft, ob der Release-Tag mit package.json übereinstimmt, führt Lint, Tests und Build aus und veröffentlicht dann mit npm-Provenienz:

npm publish --provenance --access public

Testen mit MCP Inspector

Zuerst erstellen:

pnpm build

Starten Sie den Inspector:

RAWTREE_API_KEY=rt_xxxxxxxxx pnpm inspector

Wählen Sie in der Inspector-Oberfläche stdio:

• Befehl: node

• Argumente: dist/index.js

• Umgebung: RAWTREE_API_KEY=rt_xxxxxxxxx

RawTree-Referenzen

• RawTree-Dokumentation

• llms.txt

• OpenAPI-Spezifikation