free-database-mcp-server

Справочник по подключению любого MCP-клиента к бесплатной облачной базе данных. Пятнадцать движков, одна форма конечной точки, четыре инструмента на каждое подключение — с версией и диалектом каждого движка, конфигурационным файлом каждого клиента и точными именами ключей, а также разделом устранения неполадок, основанным на ошибках, вызванных этими именами ключей. Для пошагового руководства, ориентированного на задачи, сопутствующий репозиторий mcp-database-server-free организован по задачам.

Перейти к: движки · модель доступа · инструменты · настройка клиента · устранение неполадок · выбор движка · примеры

Engines

Порт — это порт, который обычно использует протокол движка — он указывает, какой диалект и клиентские инструменты применяются, а не то, что сокет прослушивается. У каждого движка есть страница по адресу https://freebase.cloud/free-<slug>-cloud-instance (slugs: 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

How access works

Два различных пути. Их путаница — источник большинства проблем с настройкой.

Собственный проводной протокол — три движка. 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. Они говорят на своих собственных диалектах — CQL для Cassandra, Cypher для Neo4j, Flux для InfluxDB — но транспорт — HTTP, а не сырой сокет. Если вы подключаете AI-ассистента, это тот путь, который вам нужен независимо от движка, потому что он одинаков для всех:

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

Токен находится в пути URL, поэтому в этом документе нигде не появляется заголовок Authorization. Следствие: URL является учётными данными. Не фиксируйте его, не вставляйте в общий конфиг и меняйте его из Settings → MCP, если вы это сделали. Транспорт — Streamable HTTP, который внутри использует события, отправляемые сервером, для потоковых ответов — это не то же самое, что устаревший транспорт HTTP+SSE с отдельной конечной точкой /sse и POST /messages. Клиенты, предлагающие оба варианта: выбирайте streamable.

The four tools

Четыре инструмента на каждое подключение, с префиксом выбранного вами имени подключения, а не имени движка. Подключение с именем db даёт вам:

Два движка добавляют помощники: PostgreSQL получает pg_dump, pg_restore и pg_tables; SQLite получает sqlite_master и sqlite_version.

Используйте annotate_table. Самые высокоокупаемые пять минут в этом документе. Модель, которая может перечислить ваши таблицы, всё равно должна угадывать, содержит ли status 'active' или 1, является ли amount_cents центами или долларами, и является ли deleted_at IS NULL способом фильтрации. Один абзац на таблицу, написанный один раз, сохраняется в подключении и применяется к каждому разговору в каждом клиенте, использующем этот токен.

Quickstart

Зарегистрируйтесь на панели управления freebase.cloud (без карты), создайте сессию, выберите движок, затем Settings → MCP → New Token → выберите подключение → скопируйте URL. Подтвердите, что он работает, прежде чем настраивать любого клиента — напечатанные четыре имени инструмента означают, что всё, что ещё не работает, является проблемой конфигурации:

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

Client setup

Claude Desktop, Claude web, Cowork

Только UI. Настройки (⌘, / Ctrl+,) → Connectors (Customize → Connectors в новых сборках) → Add custom connector → вставьте URL → Add. Включайте для каждого разговора кнопкой + в компоновщике. Доступно на Free, Pro, Max, Team и Enterprise; бесплатные аккаунты получают один пользовательский коннектор. claude_desktop_config.json не имеет представления для удалённого HTTP MCP-сервера — пост, советующий добавить его туда, предшествует streamable HTTP. Версия этих шагов для конкретного движка находится по адресу how to connect Claude to PostgreSQL и его аналогам для других 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 принимается как псевдоним для http.

ChatGPT

Настройки → Apps → Advanced settings → включите режим разработчика → Apps → Create → вставьте конечную точку → Auth None → Scan Tools → Create. Также проверьте Settings → Connectors; две страницы документации 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 теперь задокументирован как «Devin Desktop» на docs.devin.ai; корпоративные пользователи должны сначала включить MCP в настройках. В VS Code: Command Palette → 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: Settings → AI → Manage MCP servers → «Streamable HTTP or SSE Server (URL)». Его поле вставки принимает только объект сервера, без обертки mcpServers:

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

n8n: узел MCP Client Tool (1.104.0+). Server Transport → HTTP Streamable, Endpoint → ваш URL, Authentication → None. Опубликованная страница документации все еще показывает только старое поле «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, MergeTree в ClickHouse, Cypher и APOC в Neo4j, фреймворк агрегации в 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 Software Foundation, AWS, Timescale, Inc., Cockroach Labs или PostgreSQL Global Development Group.