SQL Preview
Run governed SQL queries and inspect database schemas from MCP agents.
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.6.28
- Listing updated
- 4 days ago
About SQL Preview
SQL Preview is an open-source MCP server for databases. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add sql-preview --env SQL_PREVIEW_CONNECTIONS='<SQL_PREVIEW_CONNECTIONS>' -- npx -y sql-previewAdd to claude_desktop_config.json
{
"mcpServers": {
"sql-preview": {
"command": "npx",
"args": [
"-y",
"sql-preview"
],
"env": {
"SQL_PREVIEW_CONNECTIONS": "<SQL_PREVIEW_CONNECTIONS>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"sql-preview": {
"command": "npx",
"args": [
"-y",
"sql-preview"
],
"env": {
"SQL_PREVIEW_CONNECTIONS": "<SQL_PREVIEW_CONNECTIONS>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"sql-preview": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"sql-preview"
],
"env": {
"SQL_PREVIEW_CONNECTIONS": "<SQL_PREVIEW_CONNECTIONS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"sql-preview": {
"command": "npx",
"args": [
"-y",
"sql-preview"
],
"env": {
"SQL_PREVIEW_CONNECTIONS": "<SQL_PREVIEW_CONNECTIONS>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"sql-preview": {
"command": "npx",
"args": [
"-y",
"sql-preview"
],
"env": {
"SQL_PREVIEW_CONNECTIONS": "<SQL_PREVIEW_CONNECTIONS>"
}
}
}
}Configuration
SQL_PREVIEW_CONNECTIONSJSON array of SQL Preview connection profiles for headless use.SQL_PREVIEW_MCP_SAFE_MODESet to false to allow mutating SQL. Defaults to true.SQL_PREVIEW_MAX_ROWSMaximum rows returned by query tools. Defaults to 10000.
Pricing
Open source
SQL Preview FAQ
Is SQL Preview free?
Yes. SQL Preview is open source, so you can use and self-host it for free.
How do I add SQL Preview to Claude Code?
Run this command in your terminal: claude mcp add sql-preview --env SQL_PREVIEW_CONNECTIONS='<SQL_PREVIEW_CONNECTIONS>' -- npx -y sql-preview
What are the best alternatives to SQL Preview?
The closest alternatives to SQL Preview are Midplane, PlatypusDB, Lorebase, Sovaria and model2data studio.
Alternatives to SQL Preview

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases

PlatypusDB
MCP serverGives MCP clients access to your PlatypusDB database connections, scoped per agent
Runs locally- Open source
- Databases

Lorebase
MCP serverLets agents read and change a governed, versioned Postgres knowledge graph
Runs locally- Open source
- Knowledge and memory
Sovaria
MCP serverManage a Sovaria backend (Postgres, auth, storage, functions) from an AI assistant
Not checked yet- 4 tools
- Remote
- Freemium
- Databases

model2data studio
MCP serverGenerate realistic connected test data, dbt projects and dashboards from a schema
- Remote
- Freemium
- Databases

semlayer
MCP serverInfers a semantic layer from your data warehouse and serves it to agents
Runs locally- Free
- Databases