free-database-mcp-server

Una referencia para conectar cualquier cliente MCP a una base de datos en la nube gratuita. Quince motores, una forma de endpoint, cuatro herramientas por conexión — con la versión y dialecto de cada motor, el archivo de configuración de cada cliente y sus nombres de clave exactos, y una sección de solución de problemas construida a partir de los errores que causan esos nombres de clave. Para un tutorial orientado a tareas, el repositorio complementario mcp-database-server-free está organizado por trabajo.

Saltar a: motores · modelo de acceso · herramientas · configuración del cliente · solución de problemas · elegir un motor · ejemplos

Motores

Puerto es el puerto que el protocolo de ese motor usa convencionalmente — te dice qué dialecto y herramientas de cliente se aplican, no que haya un socket escuchando. Cada motor tiene una página en https://freebase.cloud/free-<slug>-cloud-instance (slugs: postgresql, mysql, mongodb, redis, sqlite, cassandra, dynamodb, clickhouse, elasticsearch, neo4j, mariadb, influxdb, prometheus, timescaledb, cockroachdb), además de una guía de Claude en https://freebase.cloud/how-to-connect-claude-to-<slug> — por ejemplo la página de instancia de Elasticsearch.

Related MCP server: mcp-database

Cómo funciona el acceso

Dos caminos distintos. Confundirlos es la fuente de la mayoría de los problemas de configuración.

Protocolo nativo por cable — tres motores. PostgreSQL, Redis y MongoDB aceptan controladores reales a través de sus protocolos reales: psql/libpq/Prisma/SQLAlchemy/pgx, redis-cli/ioredis/redis-py/Lettuce a través de RESP2, mongosh/Mongoose/el controlador nativo a través de OP_MSG. Nada está proxyficado o reformado.

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

HTTP y MCP — los quince. Los otros doce se alcanzan a través de la API de consulta HTTP alojada y a través de MCP. Hablan sus propios dialectos — CQL para Cassandra, Cypher para Neo4j, Flux para InfluxDB — pero el transporte es HTTP, no un socket sin procesar. Si estás conectando un asistente de IA, este es el camino que deseas independientemente del motor, porque es idéntico para todos ellos:

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

El token está en la ruta URL, por lo que no aparece ningún encabezado Authorization en este documento. La consecuencia: la URL es la credencial. No la confirmes, no la pegues en una configuración compartida y gírala desde Settings → MCP si haces cualquiera de esos dos. El transporte es Streamable HTTP, que usa eventos enviados por el servidor internamente para respuestas transmitidas — no es lo mismo que el transporte HTTP+SSE obsoleto con su endpoint /sse separado y POST /messages. Los clientes que ofrecen ambos: elige streamable.

Las cuatro herramientas

Cuatro herramientas por conexión, prefijadas con el nombre de conexión que elegiste, no el nombre del motor. Una conexión llamada db te da:

Dos motores añaden ayudantes: PostgreSQL obtiene pg_dump, pg_restore y pg_tables; SQLite obtiene sqlite_master y sqlite_version.

Usa annotate_table. Los cinco minutos de mayor rendimiento en este documento. Un modelo que pueda listar tus tablas aún tiene que adivinar si status contiene 'active' o 1, si amount_cents está en centavos o dólares, y si deleted_at IS NULL es cómo filtrar. Un párrafo por tabla, escrito una vez, persiste en la conexión y se aplica a cada conversación en cada cliente que use ese token.

Inicio rápido

Regístrate en el panel de control de freebase.cloud (sin tarjeta), crea una sesión, elige un motor, luego Settings → MCP → New Token → selecciona la conexión → copia la URL. Confirma que funciona antes de configurar cualquier cliente — cuatro nombres de herramientas impresos significa que cualquier cosa que aún esté rota es configuración:

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

Configuración del cliente

Claude Desktop, Claude web, Cowork

Solo interfaz de usuario. Configuración (⌘, / Ctrl+,) → Connectors (Customize → Connectors en versiones más recientes) → Add custom connector → pega la URL → Add. Habilita por conversación con el botón + en el compositor. Disponible en Free, Pro, Max, Team y Enterprise; las cuentas Free obtienen un conector personalizado. claude_desktop_config.json no tiene representación para un servidor MCP HTTP remoto — una publicación que te diga que agregues uno allí es anterior a streamable HTTP. La versión específica del motor de estos pasos se encuentra en cómo conectar Claude a PostgreSQL y sus hermanos para los otros 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 se acepta como un alias para http.

ChatGPT

Configuración → Apps → Advanced settings → habilita el modo desarrollador → Apps → Create → pega el endpoint → Auth None → Scan Tools → Create. También revisa Configuración → Connectors; las dos páginas de documentación de OpenAI no están de acuerdo sobre dónde vive esto. El modo desarrollador está documentado para Pro, Plus, Business, Enterprise y Edu; actualmente, el acceso completo de escritura se está implementando para espacios de trabajo Business, Enterprise y Edu, por lo que en algunos planes obtienes acceso de solo lectura a las herramientas hoy.

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 ahora está documentado como "Devin Desktop" en docs.devin.ai; los usuarios Enterprise deben habilitar MCP en la configuración primero. En VS Code, Paleta de comandos → MCP: Add Server construye el archivo, y el bloque inputs mantiene el token fuera de él para que la configuración se pueda confirmar.

Cline y Roo Code

Mismo transporte, diferente ortografía, sin fallback entre ellos.

// 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 } } }

En settings.json, la clave es httpUrl. url simple significa SSE — una mala configuración que produce un servidor que parece conectarse y luego nunca devuelve una herramienta. La aplicación Gemini de consumo no admite servidores MCP personalizados; eso es solo para Gemini Enterprise.

Warp y n8n

Warp: Configuración → AI → Manage MCP servers → "Streamable HTTP or SSE Server (URL)". Su cuadro de pegado toma solo el objeto del servidor, sin envoltorio mcpServers:

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

n8n: nodo MCP Client Tool (1.104.0+). Transporte del servidor → HTTP Streamable, Endpoint → tu URL, Autenticación → None. La página de documentación publicada aún muestra solo el antiguo campo "SSE Endpoint"; una compilación actual del nodo tiene el menú desplegable de transporte.

LangChain y 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 (solo fallback)

Para un cliente solo stdio. Requiere Node; su propio README lo llama experimental, por lo que es preferible usar soporte HTTP nativo donde un cliente lo tenga.

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

Solución de problemas de configuración

Elegir un motor

Relacional de propósito general → PostgreSQL (también el único motor con ayudas de dump/restore a través de MCP). Un esquema MySQL existente, PHP o WordPress → MySQL, o MariaDB para secuencias, tablas versionadas por sistema y columnas dinámicas. Documentos flexibles y Mongoose → MongoDB. Caché, sesiones, contadores, límites de tasa, cualquier cosa con TTL → Redis. Pequeño y ligero en esquema → SQLite. Análisis sobre muchas filas → ClickHouse. Búsqueda de texto completo y clasificación → Elasticsearch. Datos conectados, recomendaciones, memoria de agente → Neo4j. Métricas de dispositivos → InfluxDB; de exportadores y bibliotecas cliente → Prometheus; junto a tablas relacionales → TimescaleDB. Columnas anchas a escala o aprendiendo CQL → Cassandra. Diseño de tabla única con código AWS SDK → DynamoDB. SQL distribuido, serializable por defecto → CockroachDB.

Ejemplos

examples/list_tools.py imprime cada herramienta con su esquema de entrada — ejecútalo primero. dialects.json contiene sentencias de escritura y lectura para los 15 motores, y examples/clients/ tiene archivos de configuración listos para copiar para diez clientes.

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

roundtrip.mjs escribe registros de marcadores, los lee de vuelta e informa si lo que salió coincide con lo que entró. Ejecútalo contra dos motores para ver cuánto — y cuán poco — cambia entre ellos.

Límites

El nivel gratuito está destinado a desarrollo, prototipado y cargas de trabajo pequeñas de producción. Los motores se ejecutan en las versiones de la tabla anterior con sus conjuntos de características reales: transacciones en PostgreSQL, el pipeline de agregación en MongoDB, MergeTree en ClickHouse, Cypher y APOC en Neo4j, el framework de agregaciones en Elasticsearch. No se reclama aquí ningún SLA, cifra de tiempo de actividad, garantía de respaldo o número de almacenamiento, porque ninguno está verificado — el panel muestra las cuotas actuales. Trata cualquier cosa que no puedas permitirte perder como que necesita su propia copia de seguridad. Para escala de producción, recursos dedicados y una relación de soporte, las ofertas gestionadas de los propios proveedores siguen siendo la respuesta correcta.

Enlaces

freebase.cloud · especificación de MCP (revisión 2026-07-28) · referencia de transporte

Afiliación. freebase.cloud es un servicio independiente y no está afiliado con Anthropic, OpenAI, Google, Microsoft, Anysphere, Codeium, Zed Industries, Warp, n8n, Oracle, MongoDB, Inc., Redis Ltd., Elasticsearch B.V., Neo4j, Inc., InfluxData, ClickHouse, Inc., la Apache Software Foundation, AWS, Timescale, Inc., Cockroach Labs o el PostgreSQL Global Development Group.