free-database-mcp-server

一个参考指南，用于将任何 MCP 客户端连接到免费云数据库。十五种引擎，一种端点形状，每个连接四个工具——包含每个引擎的版本和方言、每个客户端的配置文件和确切键名，以及一个基于这些键名常见错误构建的故障排除部分。如需面向任务的逐步指南，配套仓库 mcp-database-server-free 按任务组织。

跳转到：引擎 · 访问模型 · 工具 · 客户端配置 · 故障排除 · 选择引擎 · 示例

引擎

端口 是该引擎协议通常使用的端口——它告诉你适用哪种方言和客户端工具，而不是表示有套接字在监听。每个引擎都有一个页面，网址为 https://freebase.cloud/free-<slug>-cloud-instance（slug：postgresql、mysql、mongodb、redis、sqlite、cassandra、dynamodb、clickhouse、elasticsearch、neo4j、mariadb、influxdb、prometheus、timescaledb、cockroachdb），以及一个 Claude 指南，网址为 https://freebase.cloud/how-to-connect-claude-to-<slug>——例如 Elasticsearch 实例页面。

Related MCP server: mcp-database

访问工作原理

两条不同的路径。混淆它们是最常见的配置问题根源。

原生有线协议——三种引擎。 PostgreSQL、Redis 和 MongoDB 通过其真实协议接受真实驱动程序：psql/libpq/Prisma/SQLAlchemy/pgx、redis-cli/ioredis/redis-py/Lettuce 通过 RESP2、mongosh/Mongoose/原生驱动程序通过 OP_MSG。没有任何代理或重构。

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

HTTP 和 MCP——全部十五种。 其他十二种通过托管的 HTTP 查询 API 和 MCP 访问。它们使用自己的方言——Cassandra 的 CQL、Neo4j 的 Cypher、InfluxDB 的 Flux——但传输层是 HTTP，而不是原始套接字。如果你正在为 AI 助手配置连接，无论使用哪种引擎，这都是你想要的路径，因为所有引擎的路径完全相同：

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

令牌位于 URL 路径中，因此本文档中不会出现 Authorization 标头。后果：URL 本身就是凭证。不要提交到版本控制，不要粘贴到共享配置中，如果做过这些操作，请从 设置 → MCP 轮换令牌。传输层是 Streamable HTTP，它在内部使用服务器发送事件来实现流式响应——这与已弃用的 HTTP+SSE 传输不同，后者有单独的 /sse 端点和 POST /messages。同时提供这两种的客户端：请选择 streamable。

四个工具

每个连接四个工具，以你选择的连接名称作为前缀，而不是引擎名称。一个名为 db 的连接会提供：

两种引擎有额外工具：PostgreSQL 获得 pg_dump、pg_restore 和 pg_tables；SQLite 获得 sqlite_master 和 sqlite_version。

使用 annotate_table。 这是本文档中五分钟内回报最高的操作。一个能列出你表的模型仍然需要猜测 status 是 'active' 还是 1，amount_cents 是分还是美元，以及 deleted_at IS NULL 是否是过滤条件。每个表一段描述，写一次，持久化在连接上，并适用于使用该令牌的每个客户端中的每次对话。

快速入门

在 freebase.cloud 控制面板 上注册（无需信用卡），创建一个会话，选择一种引擎，然后 设置 → MCP → 新建令牌 → 选择连接 → 复制 URL。在配置任何客户端之前确认其正常工作——打印出四个工具名称意味着任何仍然损坏的东西都是配置问题：

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

客户端配置

Claude Desktop、Claude web、Cowork

仅 UI。设置（⌘, / Ctrl+,）→ 连接器（较新版本中为 自定义 → 连接器）→ 添加自定义连接器 → 粘贴 URL → 添加。在每次对话中通过编辑器中的 + 按钮启用。适用于 Free、Pro、Max、Team 和 Enterprise 计划；免费账户只能使用一个自定义连接器。 claude_desktop_config.json 中没有远程 HTTP MCP 服务器的表示——告诉你在那里添加的描述在 streamable HTTP 出现之前就已存在。这些步骤的引擎特定版本位于 如何连接 Claude 到 PostgreSQL 及其对应其他 slug 的页面。

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 可以作为 http 的别名接受。

ChatGPT

设置 → 应用 → 高级设置 → 启用开发者模式 → 应用 → 创建 → 粘贴端点 → 认证 无 → 扫描工具 → 创建。同时检查设置 → 连接器；OpenAI 的两个文档页面对此位置描述不一致。开发者模式文档适用于 Pro、Plus、Business、Enterprise 和 Edu 计划；完全写入权限目前正在逐步推送到 Business、Enterprise 和 Edu 工作区，因此某些计划上目前可能只有只读工具访问权限。

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 现在在 docs.devin.ai 上被称为 "Devin Desktop"；企业用户必须先在设置中启用 MCP。在 VS Code 中，命令面板 → MCP: Add Server 构建文件，inputs 块将令牌排除在外，以便配置可以提交。

Cline 和 Roo Code

相同的传输层，不同的拼写，两者之间没有回退。

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

在 settings.json 中，键是 httpUrl。普通的 url 表示 SSE —— 这是一种错误配置，会导致服务器看似连接成功但从不返回工具。消费端的 Gemini 应用程序不支持自定义 MCP 服务器；这仅适用于 Gemini Enterprise。

Warp 和 n8n

Warp：设置 → AI → 管理 MCP 服务器 → "Streamable HTTP 或 SSE 服务器 (URL)"。其粘贴框仅接受服务器对象，无需 mcpServers 包装器：

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

n8n：MCP 客户端工具 节点 (1.104.0+)。服务器传输 → HTTP Streamable，端点 → 你的 URL，身份验证 → 无。已发布的文档页面仍仅显示旧的 "SSE Endpoint" 字段；节点的当前版本具有传输下拉菜单。

LangChain 和 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（仅回退）

适用于仅支持 stdio 的客户端。需要 Node；其自己的 README 称其为实验性的，因此只要客户端有原生 HTTP 支持，就优先使用它。

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

配置故障排除

选择引擎

通用关系型 → PostgreSQL（也是唯一通过 MCP 提供转储/恢复辅助工具的引擎）。现有的 MySQL 模式、PHP 或 WordPress → MySQL，或用于序列、系统版本表和动态列的 MariaDB。灵活文档和 Mongoose → MongoDB。缓存、会话、计数器、速率限制，任何带有 TTL 的内容 → Redis。小型且模式精简 → SQLite。大量行的分析 → ClickHouse。全文搜索和排名 → Elasticsearch。关联数据、推荐、代理记忆 → Neo4j。来自设备的指标 → InfluxDB；来自导出器和客户端库 → Prometheus；在关系表旁边 → TimescaleDB。大规模宽列或学习 CQL → Cassandra。针对 AWS SDK 代码的单表设计 → DynamoDB。分布式 SQL，默认可序列化 → CockroachDB。

示例

examples/list_tools.py 打印每个工具及其输入模式 —— 先运行它。dialects.json 包含所有 15 个引擎的写入和读取语句，examples/clients/ 包含十个客户端的即用配置文件。

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

roundtrip.mjs 写入书签记录，读回它们，并报告输出内容是否与输入内容匹配。针对两个引擎运行它，以了解它们之间有多少（以及有多少）变化。

限制

免费层旨在用于开发、原型设计和小型生产工作负载。引擎以上表中的版本运行，并具有其真实功能集：PostgreSQL 上的事务，MongoDB 上的聚合管道，ClickHouse 上的 MergeTree，Neo4j 上的 Cypher 和 APOC，Elasticsearch 上的聚合框架。此处未声明任何 SLA、正常运行时间数字、备份保证或存储数字，因为没有任何经过验证的 —— 仪表板 显示当前配额。将你无法承受丢失的任何内容视为需要自己的备份。对于生产规模、专用资源和支持关系，供应商自己的托管服务仍然是正确的答案。

链接

freebase.cloud · MCP 规范 (修订版 2026-07-28) · 传输参考

隶属关系声明。 freebase.cloud 是一个独立服务，与 Anthropic、OpenAI、Google、Microsoft、Anysphere、Codeium、Zed Industries、Warp、n8n、Oracle， MongoDB, Inc.、Redis Ltd.、Elasticsearch B.V.、Neo4j, Inc.、InfluxData、ClickHouse, Inc.、Apache 软件基金会、AWS、Timescale, Inc.、Cockroach Labs 或 PostgreSQL 全球开发组均无关联。