free-database-mcp-server

Eine Referenz zum Verbinden eines beliebigen MCP-Clients mit einer kostenlosen Cloud-Datenbank. Fünfzehn Engines, eine Endpunktform, vier Tools pro Verbindung — mit der Version und dem Dialekt jeder Engine, der Konfigurationsdatei jedes Clients und seinen genauen Schlüsselnamen sowie einem Troubleshooting-Abschnitt, der aus den Fehlern aufgebaut ist, die diese Schlüsselnamen verursachen. Für eine aufgabenorientierte Schritt-für-Schritt-Anleitung ist das Begleit-Repository mcp-database-server-free nach Aufgaben organisiert.

Springe zu: Engines · Zugriffsmodell · Tools · Client-Einrichtung · Fehlerbehebung · Engine auswählen · Beispiele

Engines

Port ist der Port, den das Protokoll dieser Engine üblicherweise verwendet — er sagt Ihnen, welcher Dialekt und welche Client-Tools zutreffen, nicht, dass ein Socket lauscht. Jede Engine hat eine Seite unter https://freebase.cloud/free-<slug>-cloud-instance (Slugs: postgresql, mysql, mongodb, redis, sqlite, cassandra, dynamodb, clickhouse, elasticsearch, neo4j, mariadb, influxdb, prometheus, timescaledb, cockroachdb), plus eine Claude-Anleitung unter https://freebase.cloud/how-to-connect-claude-to-<slug> — zum Beispiel für die Elasticsearch-Instanzseite.

Related MCP server: mcp-database

Wie der Zugriff funktioniert

Zwei unterschiedliche Pfade. Sie zu verwechseln ist die Ursache der meisten Einrichtungsprobleme.

Natives Wire-Protokoll — drei Engines. PostgreSQL, Redis und MongoDB akzeptieren echte Treiber über ihre echten Protokolle: psql/libpq/Prisma/SQLAlchemy/pgx, redis-cli/ioredis/redis-py/Lettuce über RESP2, mongosh/Mongoose/den nativen Treiber über OP_MSG. Nichts wird weitergeleitet oder umgeformt.

postgresql://freebase@HOST:5432/DBNAME    redis://HOST:6379    mongodb://HOST:27017/DBNAME

HTTP und MCP — alle fünfzehn. Die anderen zwölf werden über die gehostete HTTP-Abfrage-API und über MCP erreicht. Sie sprechen ihre eigenen Dialekte — CQL zu Cassandra, Cypher zu Neo4j, Flux zu InfluxDB — aber der Transport ist HTTP, kein roher Socket. Wenn Sie einen KI-Assistenten anschließen, ist dies der Pfad, den Sie unabhängig von der Engine wählen möchten, da er für alle identisch ist:

https://freebase.cloud/api/mcp/YOUR_TOKEN

Das Token befindet sich im URL-Pfad, sodass in diesem Dokument kein Authorization-Header erscheint. Die Konsequenz: Die URL ist die Anmeldeinformation. Committen Sie sie nicht, fügen Sie sie nicht in eine gemeinsam genutzte Konfiguration ein und rotieren Sie sie über Einstellungen → MCP, falls Sie dies doch tun. Der Transport ist Streamable HTTP, der intern Server-Sent-Events für gestreamte Antworten verwendet — nicht dasselbe wie der veraltete HTTP+SSE-Transport mit seinem separaten /sse-Endpunkt und POST /messages. Clients, die beides anbieten: wählen Sie streamable.

Die vier Tools

Vier Tools pro Verbindung, mit dem von Ihnen gewählten Verbindungsnamen als Präfix, nicht dem Engine-Namen. Eine Verbindung namens db gibt Ihnen:

Zwei Engines fügen Helfer hinzu: PostgreSQL erhält pg_dump, pg_restore und pg_tables; SQLite erhält sqlite_master und sqlite_version.

Verwenden Sie annotate_table. Die fünf Minuten mit der höchsten Rendite in diesem Dokument. Ein Modell, das Ihre Tabellen auflisten kann, muss immer noch raten, ob status 'active' oder 1 enthält, ob amount_cents Cent oder Dollar sind und ob deleted_at IS NULL die Art und Weise ist, wie Sie filtern. Ein Absatz pro Tabelle, einmal geschrieben, bleibt auf der Verbindung bestehen und gilt für jedes Gespräch in jedem Client, der dieses Token verwendet.

Kurzanleitung

Registrieren Sie sich auf dem freebase.cloud-Dashboard (keine Karte), erstellen Sie eine Sitzung, wählen Sie eine Engine aus, dann Einstellungen → MCP → Neues Token → wählen Sie die Verbindung aus → kopieren Sie die URL. Bestätigen Sie, dass es funktioniert, bevor Sie irgendeinen Client konfigurieren — vier gedruckte Toolnamen bedeuten, dass alles, was noch kaputt ist, die Konfiguration ist:

export FREEBASE_MCP_URL="https://freebase.cloud/api/mcp/YOUR_TOKEN"
python3 examples/list_tools.py

Client-Einrichtung

Claude Desktop, Claude Web, Cowork

Nur UI. Einstellungen (⌘, / Strg+,) → Konnektoren (Anpassen → Konnektoren in neueren Builds) → Benutzerdefinierten Konnektor hinzufügen → URL einfügen → Hinzufügen. Pro Gespräch mit der +-Schaltfläche im Composer aktivieren. Verfügbar auf Free, Pro, Max, Team und Enterprise; Free-Konten erhalten einen benutzerdefinierten Konnektor. claude_desktop_config.json hat keine Repräsentation für einen entfernten HTTP-MCP-Server — ein Beitrag, der Ihnen sagt, Sie sollen dort einen hinzufügen, stammt aus der Zeit vor Streamable HTTP. Die enginespezifische Version dieser Schritte befindet sich unter So verbinden Sie Claude mit PostgreSQL und seinen Geschwistern für die anderen Slugs.

Claude Code

claude mcp add --transport http db https://freebase.cloud/api/mcp/YOUR_TOKEN
#   --scope project  writes .mcp.json (commit it, minus the token) | --scope user = all projects

{ "mcpServers": { "db": { "type": "http", "url": "https://freebase.cloud/api/mcp/YOUR_TOKEN" } } }

streamable-http wird als Alias für http akzeptiert.

ChatGPT

Einstellungen → Apps → Erweiterte Einstellungen → Entwicklermodus aktivieren → Apps → Erstellen → Endpunkt Einfügen → Auth Keine → Tools scannen → Erstellen. Überprüfen Sie auch Einstellungen → Konnektoren; die beiden Dokumentationsseiten von OpenAI sind sich nicht einig, wo dies zu finden ist. Der Entwicklermodus ist für Pro, Plus, Business, Enterprise und Edu dokumentiert; der vollständige Schreibzugriff wird derzeit für Business, Enterprise und Edu-Arbeitsbereiche ausgerollt, sodass Sie bei einigen Tarifen heute nur schreibgeschützten Tool-Zugriff erhalten.

OpenAI Responses API

{
  "model": "gpt-5.6",
  "tools": [{
    "type": "mcp",
    "server_label": "db",
    "server_description": "Free cloud database — query and store structured data.",
    "server_url": "https://freebase.cloud/api/mcp/YOUR_TOKEN",
    "require_approval": "never"
  }],
  "input": "List the tables in my database."
}

Cursor, Windsurf, VS Code, Zed

// ~/.cursor/mcp.json  or  .cursor/mcp.json     — NO "type" key
{ "mcpServers": { "db": { "url": "https://freebase.cloud/api/mcp/YOUR_TOKEN" } } }

// ~/.codeium/windsurf/mcp_config.json          — the key is serverUrl
{ "mcpServers": { "db": { "serverUrl": "https://freebase.cloud/api/mcp/YOUR_TOKEN" } } }

// .vscode/mcp.json                             — top-level key is "servers"
{
  "inputs": [{ "type": "promptString", "id": "fb-token", "description": "freebase.cloud MCP token", "password": true }],
  "servers": { "db": { "type": "http", "url": "https://freebase.cloud/api/mcp/${input:fb-token}" } }
}

// Zed settings.json                            — "context_servers", not "mcpServers"
{ "context_servers": { "db": { "url": "https://freebase.cloud/api/mcp/YOUR_TOKEN" } } }

Windsurf wird jetzt als "Devin Desktop" auf docs.devin.ai dokumentiert; Enterprise-Benutzer müssen MCP zuerst in den Einstellungen aktivieren. In VS Code erstellt die Befehlspalette → MCP: Add Server die Datei, und der inputs-Block hält das Token daraus heraus, sodass die Konfiguration committbar bleibt.

Cline und Roo Code

Gleicher Transport, andere Schreibweise, kein Fallback zwischen ihnen.

// Cline — camelCase
{ "mcpServers": { "db": { "type": "streamableHttp", "url": "https://freebase.cloud/api/mcp/YOUR_TOKEN", "disabled": false, "autoApprove": [] } } }

// Roo Code, .roo/mcp.json — kebab-case
{ "mcpServers": { "db": { "type": "streamable-http", "url": "https://freebase.cloud/api/mcp/YOUR_TOKEN" } } }

Gemini CLI

gemini mcp add --transport http db https://freebase.cloud/api/mcp/YOUR_TOKEN

{ "mcpServers": { "db": { "httpUrl": "https://freebase.cloud/api/mcp/YOUR_TOKEN", "timeout": 5000 } } }

In settings.json ist der Schlüssel httpUrl. Einfaches url bedeutet SSE – eine Fehlkonfiguration, die einen Server erzeugt, der scheinbar verbindet und dann nie ein Tool zurückgibt. Die Consumer-Gemini-App unterstützt keine benutzerdefinierten MCP-Server; das ist nur für Gemini Enterprise.

Warp und n8n

Warp: Einstellungen → KI → MCP-Server verwalten → "Streamable HTTP or SSE Server (URL)". Sein Eingabefeld nimmt nur das Server-Objekt entgegen, ohne mcpServers-Wrapper:

{ "db": { "url": "https://freebase.cloud/api/mcp/YOUR_TOKEN" } }

n8n: MCP-Client-Tool-Knoten (1.104.0+). Server-Transport → HTTP Streamable, Endpunkt → Ihre URL, Authentifizierung → Keine. Die veröffentlichte Dokumentationsseite zeigt noch immer nur das alte "SSE-Endpunkt"-Feld; ein aktueller Build des Knotens hat das Transport-Dropdown.

LangChain und LlamaIndex

from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({"db": {"transport": "http", "url": "https://freebase.cloud/api/mcp/YOUR_TOKEN"}})
tools = await client.get_tools()

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
tools = await McpToolSpec(client=BasicMCPClient("https://freebase.cloud/api/mcp/YOUR_TOKEN")).to_tool_list_async()

mcp-remote (nur Fallback)

Für einen reinen stdio-Client. Erfordert Node; seine eigene README bezeichnet es als experimentell, daher natives HTTP unterstützen, wo immer ein Client es hat.

{ "mcpServers": { "db": { "command": "npx", "args": ["-y", "mcp-remote", "https://freebase.cloud/api/mcp/YOUR_TOKEN", "--transport", "http-only"] } } }

Fehlerbehebung bei der Konfiguration

Auswahl einer Engine

Allzweck-relational → PostgreSQL (auch die einzige Engine mit Dump/Restore-Helfern über MCP). Ein bestehendes MySQL-Schema, PHP oder WordPress → MySQL, oder MariaDB für Sequenzen, systemversionierte Tabellen und dynamische Spalten. Flexible Dokumente und Mongoose → MongoDB. Cache, Sitzungen, Zähler, Ratenbegrenzungen, alles mit TTL → Redis. Klein und schemaleicht → SQLite. Analytik über viele Zeilen → ClickHouse. Volltextsuche und Ranking → Elasticsearch. Vernetzte Daten, Empfehlungen, Agentenspeicher → Neo4j. Metriken von Geräten → InfluxDB; von Exporteuren und Client-Bibliotheken → Prometheus; neben relationalen Tabellen → TimescaleDB. Breitspalten im großen Maßstab oder CQL lernen → Cassandra. Single-Table-Design gegen AWS-SDK-Code → DynamoDB. Verteiltes SQL, standardmäßig serialisierbar → CockroachDB.

Beispiele

examples/list_tools.py gibt jedes Tool mit seinem Eingabeschema aus – führen Sie es zuerst aus. dialects.json enthält Schreib- und Leseanweisungen für alle 15 Engines, und examples/clients/ hat fertig zu kopierende Konfigurationsdateien für zehn Clients.

node examples/roundtrip.mjs postgresql         # end-to-end write + read
node examples/roundtrip.mjs redis --keep       # leave the data behind

roundtrip.mjs schreibt Lesezeichen-Datensätze, liest sie zurück und meldet, ob das, was herauskam, mit dem übereinstimmt, was hineinging. Führen Sie es gegen zwei Engines aus, um zu sehen, wie viel – und wie wenig – sich zwischen ihnen ändert.

Grenzen

Die kostenlose Stufe ist für Entwicklung, Prototyping und kleine Produktions-Workloads gedacht. Engines laufen mit den Versionen in der obigen Tabelle mit ihren echten Funktionsumfängen: Transaktionen auf PostgreSQL, die Aggregations-Pipeline auf MongoDB, MergeTree auf ClickHouse, Cypher und APOC auf Neo4j, das Aggregations-Framework auf Elasticsearch. Es wird hier keine SLA, Betriebszeit, Backup-Garantie oder Speicherzahl beansprucht, da keine verifiziert ist – das Dashboard zeigt aktuelle Kontingente. Behandeln Sie alles, dessen Verlust Sie sich nicht leisten können, als ob es ein eigenes Backup benötigt. Für Produktionsumfang, dedizierte Ressourcen und eine Support-Beziehung bleiben die eigenen verwalteten Angebote der Anbieter die richtige Antwort.

Links

freebase.cloud · MCP-Spezifikation (Revision 2026-07-28) · Transportreferenz

Zugehörigkeit. freebase.cloud ist ein unabhängiger Dienst und ist nicht mit Anthropic, OpenAI, Google, Microsoft, Anysphere, Codeium, Zed Industries, Warp, n8n, Oracle, MongoDB, Inc., Redis Ltd., Elasticsearch B.V., Neo4j, Inc., InfluxData, ClickHouse, Inc., der Apache Software Foundation, AWS, Timescale, Inc., Cockroach Labs oder der PostgreSQL Global Development Group verbunden.