freebase.cloud

free-database-mcp-server

あらゆる MCP クライアントを無料のクラウドデータベースに接続するためのリファレンスです。15 種類のエンジン、共通のエンドポイント形式、接続ごとに 4 つのツールを備えています。各エンジンのバージョンと方言、各クライアントの設定ファイルと正確なキー名、そしてキー名に起因する間違いをもとに作成したトラブルシューティングのセクションを掲載しています。タスク別の手順については、関連リポジトリ mcp-database-server-free をご覧ください。

移動先：エンジン · アクセスモデル · ツール · クライアントの設定 · トラブルシューティング · エンジンの選択 · 例

エンジン

エンジン	バージョン	方言	対応 CLI	ポート	アクセス
PostgreSQL	16.2	SQL	psql	5432	ネイティブ TCP + HTTP + MCP
MySQL	8.0.36	SQL	mysql	3306	HTTP + MCP
MongoDB	7.0.4	ドキュメント型 / NoSQL	mongosh	27017	ネイティブ TCP + HTTP + MCP
Redis	7.2.3	キー・バリュー型 / インメモリ	redis-cli	6379	ネイティブ TCP + HTTP + MCP
SQLite	3.45.1	SQL	sqlite3	—	HTTP + MCP
Apache Cassandra	4.1.4	ワイドカラム型 / CQL	cqlsh	9042	HTTP + MCP
DynamoDB	2024.1	キー・バリュー型 / ドキュメント型	aws CLI	—	HTTP + MCP
ClickHouse	24.1.5	カラム型 / OLAP SQL	clickhouse-client	9000	HTTP + MCP
Elasticsearch	8.12.0	検索 / クエリ DSL	curl / ES クライアント	9200	HTTP + MCP
Neo4j	5.17.0	グラフ / Cypher	cypher-shell	7687	HTTP + MCP
MariaDB	11.3.2	SQL	mysql	3306	HTTP + MCP
InfluxDB	2.7.4	Flux / InfluxQL	influx	8086	HTTP + MCP
Prometheus	2.50.1	PromQL	promtool / curl	9090	HTTP + MCP
TimescaleDB	2.14.2	SQL（PostgreSQL + Timescale）	psql	5432	HTTP + MCP
CockroachDB	23.2.4	SQL（PostgreSQL 互換）	cockroach sql / psql	26257	HTTP + MCP

ポートは、そのエンジンのプロトコルで慣例的に使用されるポートです。適用される方言とクライアントツールを示すものであり、ソケットが待ち受けていることを意味するものではありません。各エンジンのページは https://freebase.cloud/free-<slug>-cloud-instance（スラッグ：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 インスタンスのページをご覧ください。

アクセス方法

アクセス経路は2種類あります。混同すると、セットアップで最もよく問題が発生します。

ネイティブのワイヤープロトコル — 3つのエンジン。 PostgreSQL、Redis、MongoDB は、実際のプロトコルを介して実際のドライバーを受け入れます。psql／libpq／Prisma／SQLAlchemy／pgx、RESP2 を介した redis-cli／ioredis／redis-py／Lettuce、OP_MSG を介した mongosh／Mongoose／ネイティブドライバーを使用できます。プロキシ処理もデータ形式の変更も行われません。

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 自体が認証情報になります。URL をコミットしたり、共有設定に貼り付けたりしないでください。どちらかをしてしまった場合は、Settings → MCP からトークンをローテーションしてください。トランスポートはストリーミング可能な HTTPです。ストリーミング応答には内部でサーバー送信イベントを使用します。これは、専用の /sse エンドポイントと POST /messages を使う、非推奨の HTTP+SSE トランスポートとは異なります。両方に対応するクライアントでは、ストリーミング可能な方を選んでください。

4つのツール

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

ツール	用途	エンジンごとの意味
db_query	エンジンのネイティブ言語で読み取る	SQL · CQL · Cypher · Flux · PromQL · ES クエリ DSL · Mongo の find／aggregate · Redis コマンド
db_store	挿入、アップサート、書き込み	INSERT · MERGE · _bulk · ラインプロトコル · SET · PutItem
db_list_tables	コンテナを列挙する	テーブル · コレクション · キースペース · インデックス · メジャーメント · メトリック名 · キー
db_annotate_table	コンテナに人間向けの説明を追加する	モデルが列の意味を把握できるようにします

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 ダッシュボードで登録し（カード不要）、セッションを作成してエンジンを選び、Settings → MCP → New Token に進んで接続を選択し、URL をコピーします。クライアントを設定する前に、動作を確認してください。ツール名が4つ表示されたなら、まだ問題が残っている場合は設定が原因です。

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

クライアントのセットアップ

クライアント	設定場所	トップレベルキー	URL キー	type の値
Claude Desktop / web / Cowork	UI のみ	—	—	—
Claude Code	.mcp.json / ユーザー設定	mcpServers	url	"http" (必須)
ChatGPT	UI（開発者モード）	—	—	—
OpenAI Responses API	リクエスト本文	tools[]	server_url	"mcp"
Cursor	~/.cursor/mcp.json または .cursor/mcp.json	mcpServers	url	完全に省略
Windsurf	~/.codeium/windsurf/mcp_config.json	mcpServers	serverUrl	—
VS Code / Copilot Chat	.vscode/mcp.json	servers	url	"http"
Zed	settings.json	context_servers	url	—
Cline	MCP 設定 JSON	mcpServers	url	"streamableHttp"
Roo Code	.roo/mcp.json	mcpServers	url	"streamable-http"
Gemini CLI	settings.json	mcpServers	httpUrl	—
Warp	設定 → AI → MCP サーバーを管理	(なし)	url	—
n8n	MCP Client Tool ノード	—	エンドポイント欄	HTTP Streamable
LangChain / LlamaIndex	Python	—	url	"http"

Claude Desktop、Claude web、Cowork

UI のみです。設定（⌘, / Ctrl+,）→ コネクター（新しいビルドでは カスタマイズ → コネクター）→ カスタムコネクターを追加 → URL を貼り付け → 追加します。コンポーザーの + ボタンで、会話ごとに有効にします。 Free、Pro、Max、Team、Enterprise で利用できます。Free アカウントで追加できるカスタムコネクターは 1 つです。 claude_desktop_config.json にはリモート HTTP MCP サーバーの設定項目がありません。そこに追加するよう案内する投稿は、ストリーム可能な 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」として案内されています。Enterprise ユーザーは、まず設定で 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 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 が必要です。mcp-remote 自身の README では実験的とされているため、クライアントがネイティブ HTTP に対応している場合は、そちらを優先してください。

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

設定のトラブルシューティング

症状	原因	対処方法
Claude Code が起動直後にエラーになる	url があり、type がない	"type": "http" を追加します。これは警告ではなく、致命的なエラーです
Cursor がエントリを拒否する、またはサーバーを無視する	"type" キーを追加した	削除します。Cursor では、url があることでサーバーがリモートと判定されます
VS Code がサーバーを認識しない	設定に mcpServers を使用している	.vscode/mcp.json のトップレベルキーは servers です
Windsurf でサーバーが未設定と表示される	url を使用した	キーは serverUrl です
Zed がファイルを無視する	mcpServers を使用した	Zed のキーは context_servers です
Gemini CLI は接続するが、ツールが表示されない	url を使用した	httpUrl を使用します。通常の url は SSE トランスポートを選択します
Cline がトランスポート不明と報告する	streamable-http を使用した	Cline では streamableHttp（キャメルケース）が必要です
Roo Code がトランスポート不明と報告する	streamableHttp を使用した	Roo では streamable-http（ケバブケース）が必要です
Warp が貼り付けた JSON を拒否する	mcpServers のラッパーを含めた	内側のサーバーオブジェクトのみを貼り付けます
Claude Desktop が JSON 内のサーバーを見つけられない	リモート HTTP サーバーはそこでサポートされていない	代わりに Settings → Connectors から追加します。Free ではコネクターが 1 つに制限される点に注意してください
ChatGPT でツールをスキャンできるが、書き込みができない	お使いのプランでは、書き込みアクセスの提供がまだ段階的に進められている	読み取りは可能です。ワークスペースの種類を確認してください
ツール名が予想と異なる	名前にはエンジンではなく、接続名が付く	接続名を変更するか、そのままの名前を使用します
エンドポイントから 404 が返される	トークンが取り消された、またはコピー＆ペースト時に文字が欠落した	Settings → MCP から再発行
curl では動作するが、クライアントでは失敗する	クライアントが編集したものとは異なる設定ファイルを読み込んでいる	ユーザースコープとプロジェクトスコープのパスを確認します

エンジンの選び方

汎用的なリレーショナル用途 → 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.、the Apache Software Foundation、AWS、Timescale, Inc.、Cockroach Labs、PostgreSQL Global Development Group とは提携していません。