Baserow Streamable MCP

Ein Remote‑MCP‑Server für Baserow, der Streamable HTTP und die Baserow REST API nutzt.

Dieses Repository enthält derzeit den technischen Phase‑1‑Spike. Es setzt bewusst nur eine Discovery‑ und eine Schreiboperation um, damit der gesamte Verbindungspfad validiert werden kann, bevor die umfassendere CRUD‑Implementierung entwickelt wird.

Phase‑1-Werkzeuge

• list_databases() leitet die zugänglichen Datenbank‑IDs und Tabellenanzahlen aus den für das Token sichtbaren Tabellen ab. Datenbanknamen sind null, da der Database‑Token‑Discovery‑Endpunkt von Baserow sie nicht zurückgibt.

• list_tables() listet jede Tabelle auf, die für das Database Token in seinem Workspace zugänglich ist.

• create_rows(table_id, rows) erstellt bis zu 200 Zeilen unter Verwendung der für Benutzer sichtbaren Feldnamen.

Database Tokens sind an den Workspace gebunden, und Baserow stellt einen token‑spezifischen Endpunkt für alle Tabellen bereit. Die Antwort enthält für jede Tabelle die database_id, sodass Datenbank‑IDs ohne ein JWT ermittelt und gruppiert werden können. Sie enthält keine Datenbanknamen; der Server liefert daher name: null zurück, anstatt einen Wert zu erfinden oder kurzlebige Benutzerauthentifizierung zu verlangen.

Die Phase‑-Baserow-Aufrufe folgen diesen API‑Verträgen:

• GET /api/database/tables/all-tables/ für die Ermittlung der für das Token sichtbaren Tabellen.

• POST /api/database/rows/table/{table_id}/batch/?user_field_names=true mit { "items": [...] } für die Batch‑Erstellung von Zeilen.

Related MCP server: AppFlowy Cloud MCP Server

Voraussetzungen

• Node.js 22 oder höher

• Ein Baserow Database Token mit den erforderlichen Tabellenberechtigungen

Lokal ausführen

cp .env.example .env
# Edit .env, then export it into the shell.
set -a && . ./.env && set +a
npm install
npm run build
npm start

Der MCP‑Endpunkt ist standardmäßig http://127.0.0.1:3000/mcp.

Mit Docker Compose ausführen

cp .env.example .env
# Edit .env, then start the service.
docker compose up --build -d

Das Compose‑Beispiel veröffentlicht den Port nur auf der Loopback‑Schnittstelle des Hosts. Ein Reverse‑Proxy oder Tunnel auf demselben Host kann HTTPS‑Datenverkehr and that weiterleiten. Um einen selbst gehosteten Baserow‑Dienst über den Docker‑Dienstnamen zu erreichen, verbinden Sie diesen Dienst mit demselben externen Docker‑Netzwerk und setzen Sie BASEROW_URL entsprechend.

Für den Fernzugriff platzieren Sie den Server hinter einem HTTPS‑Reverse‑Proxy oder Tunnel. Streamable HTTP ist der MCP‑Transport benutzung; HTTPS ist die äußere Sicherheitsschicht. Phase 1 sieht noch keine Authentifizierung für den MCP‑Endpunkt vor; stellen Sie den Server also nur mit Zugriffskontrolle am Proxy oder Tunnel öffentlich bereit.

Konfiguration

Entwicklung

npm run typecheck
npm test
npm run build

Sicherheit

• Commiten Sie niemals .env‑Dateien oder Tokens.

• Das Baserow‑Token wird nur im Header Authorization: Token ... gesendet.

• Der Server bindet standardmäßig an localhost.

• Konfigurieren Sie HTTPS und die Endpunkt‑Authentifizierung, bevor Sie den Server remote in der Produktion verwenden.

Lizenz

MIT