free-database-mcp-server

모든 MCP 클라이언트를 무료 클라우드 데이터베이스에 연결하기 위한 참조 자료입니다. 15개의 엔진, 하나의 엔드포인트 형태, 연결당 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

액세스 작동 방식

두 가지 별개의 경로가 있습니다. 이 둘을 혼동하는 것이 대부분의 설정 문제의 원인입니다.

네이티브 와이어 프로토콜 — 세 가지 엔진. 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을 선택하십시오.

네 가지 도구

연결당 네 가지 도구이며, 엔진 이름이 아닌 선택한 연결 이름이 접두사로 붙습니다. db라는 연결은 다음을 제공합니다:

두 엔진은 도우미를 추가합니다: PostgreSQL은 pg_dump, pg_restore 및 pg_tables를 얻습니다. **SQLite**는 sqlite_master 및 sqlite_version을 얻습니다.

annotate_table을 사용하십시오. 이 문서에서 가장 효율적인 5분입니다. 테이블을 나열할 수 있는 모델이라도 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에서 사용 가능합니다. Free 계정은 하나의 사용자 지정 커넥터를 얻습니다. 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의 두 문서 페이지는 이 위치에 대해 의견이 다릅니다. 개발자 모드는 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 또는 SSE 서버 (URL)". 붙여넣기 상자는 mcpServers 래퍼 없이 서버 객체만 허용합니다:

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

n8n: MCP 클라이언트 도구 노드 (1.104.0+). 서버 전송 → HTTP Streamable, 엔드포인트 → URL, 인증 → 없음. 게시된 문서 페이지에는 여전히 이전 "SSE 엔드포인트" 필드만 표시됩니다. 노드의 현재 빌드에는 전송 드롭다운이 있습니다.

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.js가 필요합니다. 자체 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는 북마크 레코드를 쓰고, 다시 읽어서 출력된 내용이 입력된 내용과 일치하는지 보고합니다. 두 엔진에 대해 실행하여 둘 사이에 얼마나 많은 것과 적은 것이 변경되는지 확인하세요.

제한 사항

무료 티어는 개발, 프로토타이핑 및 소규모 프로덕션 워크로드를 위한 것입니다. 엔진은 위 표의 버전에서 실제 기능 세트(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과 제휴 관계가 없습니다.