free-database-mcp-server

任意のMCPクライアントを無料のクラウドデータベースに接続するためのリファレンスです。15のエンジン、1つのエンドポイント形状、接続ごとに4つのツール。各エンジンのバージョンと方言、各クライアントの設定ファイルとその正確なキー名、そしてそれらのキー名が引き起こすミスから構築されたトラブルシューティングセクションが含まれています。タスク指向のチュートリアルについては、関連リポジトリmcp-database-server-freeがジョブごとに整理されています。

ジャンプ先: エンジン · アクセスモデル · ツール · クライアント設定 · トラブルシューティング · エンジンの選び方 · 例

エンジン

ポートは、そのエンジンのプロトコルが慣習的に使用するポートです。これは、どの方言とクライアントツールが適用されるかを示すものであり、ソケットがリッスンしていることを示すものではありません。各エンジンにはhttps://freebase.cloud/free-<slug>-cloud-instanceのページがあります（スラッグ: postgresql, mysql, mongodb, redis, sqlite, cassandra, dynamodb, clickhouse, elasticsearch, neo4j, mariadb, influxdb, prometheus, timescaledb, cockroachdb）。さらに、https://freebase.cloud/how-to-connect-claude-to-<slug>にClaudeガイドがあります。例としてElasticsearchインスタンスページを参照してください。

Related MCP server: mcp-database

アクセスの仕組み

2つの異なる経路があります。これらを混同することが、ほとんどのセットアップトラブルの原因です。

ネイティブワイヤプロトコル — 3つのエンジン。 PostgreSQL、Redis、MongoDBは、実際のプロトコルを介して実際のドライバーを受け入れます: psql/libpq/Prisma/SQLAlchemy/pgx、redis-cli/ioredis/redis-py/Lettuce over RESP2、mongosh/Mongoose/ネイティブドライバー over OP_MSG。プロキシや再整形は行われません。

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

HTTPとMCP — 全15エンジン。 残りの12エンジンは、ホスト型HTTPクエリAPIとMCPを介してアクセスされます。これらは独自の方言（CassandraへのCQL、Neo4jへのCypher、InfluxDBへのFlux）を使用しますが、トランスポートはHTTPであり、生のソケットではありません。AIアシスタントを接続する場合、エンジンに関係なくこの経路を使用します。なぜなら、すべてのエンジンで同一だからです:

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

トークンはURLパス内にあるため、このドキュメントのどこにもAuthorizationヘッダーは登場しません。結果として、URLが資格情報となります。コミットしないでください。共有設定に貼り付けないでください。もし貼り付けてしまった場合は、設定 → MCPからローテーションしてください。トランスポートはStreamable HTTPであり、ストリーミング応答のために内部的にサーバー送信イベントを使用します。これは、別個の/sseエンドポイントとPOST /messagesを持つ非推奨のHTTP+SSEトランスポートとは異なります。両方を提供するクライアントは、streamableを選択してください。

4つのツール

接続ごとに4つのツールがあり、エンジン名ではなく、選択した接続名がプレフィックスとして付きます。dbという接続の場合、次のツールが提供されます:

2つのエンジンにはヘルパーが追加されています: PostgreSQLにはpg_dump、pg_restore、pg_tablesがあります。**SQLite**にはsqlite_masterとsqlite_versionがあります。

annotate_tableを使用してください。 このドキュメントの中で最も効果的な5分間です。テーブルを一覧表示できるモデルでも、statusが'active'か1か、amount_centsがセントかドルか、deleted_at IS NULLがフィルタ条件かどうかを推測する必要があります。テーブルごとに1段落、一度書けば、その接続に永続化され、そのトークンを使用するすべてのクライアントのすべての会話に適用されます。

クイックスタート

freebase.cloudダッシュボードにサインアップし（カード不要）、セッションを作成し、エンジンを選択してから、設定 → MCP → 新しいトークン → 接続を選択 → URLをコピーします。クライアントを設定する前に動作確認を行ってください。4つのツール名が表示されれば、残りの問題は設定だけです:

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で利用可能。Freeアカウントはカスタムコネクタを1つだけ使用できます。 claude_desktop_config.jsonにはリモートHTTP MCPサーバーの表現はありません。そこに追加するように指示する投稿は、streamable HTTPより前のものです。エンジン固有の手順は、ClaudeをPostgreSQLに接続する方法および他のスラッグの姉妹ページにあります。

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の2つのドキュメントページでこの場所が異なっています。開発者モードは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 → 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/ には 10 のクライアント用のコピー可能な設定ファイルがあります。

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

roundtrip.mjs はブックマークレコードを書き込み、それらを読み戻し、出力が入力と一致するかどうかを報告します。2 つのエンジンに対して実行して、それらの間でどれだけ変化するか、そしてどれだけ変化しないかを確認してください。

制限

無料ティアは開発、プロトタイピング、および小規模な本番ワークロードを対象としています。エンジンは上記の表のバージョンで、実際の機能セット（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 Software Foundation、AWS、Timescale, Inc.、Cockroach Labs、または PostgreSQL Global Development Group とは提携していません。