sql-steward
The agent never writes SQL: queries compile from a semantic layer you control, PII…
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.4.0
- Listing updated
- 4 days ago
About sql-steward
sql-steward is an open-source MCP server for databases. It runs locally on your machine and is started by your AI client.
The agent never writes SQL: queries compile from a semantic layer you control, PII refused first.
Install
Run in a terminal
claude mcp add sql-steward --env SQL_STEWARD_DB_URL='<SQL_STEWARD_DB_URL>' -- uvx sql-stewardAdd to claude_desktop_config.json
{
"mcpServers": {
"sql-steward": {
"command": "uvx",
"args": [
"sql-steward"
],
"env": {
"SQL_STEWARD_DB_URL": "<SQL_STEWARD_DB_URL>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"sql-steward": {
"command": "uvx",
"args": [
"sql-steward"
],
"env": {
"SQL_STEWARD_DB_URL": "<SQL_STEWARD_DB_URL>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"sql-steward": {
"type": "stdio",
"command": "uvx",
"args": [
"sql-steward"
],
"env": {
"SQL_STEWARD_DB_URL": "<SQL_STEWARD_DB_URL>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"sql-steward": {
"command": "uvx",
"args": [
"sql-steward"
],
"env": {
"SQL_STEWARD_DB_URL": "<SQL_STEWARD_DB_URL>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"sql-steward": {
"command": "uvx",
"args": [
"sql-steward"
],
"env": {
"SQL_STEWARD_DB_URL": "<SQL_STEWARD_DB_URL>"
}
}
}
}Configuration
SQL_STEWARD_DB_URLSQLAlchemy URL of the database to read (read-only account recommended)RequiredSQL_STEWARD_LAYERPath to the semantic layer YAML (default: semantic.yaml)
Pricing
Open source
sql-steward FAQ
Is sql-steward free?
Yes. sql-steward is open source, so you can use and self-host it for free.
How do I add sql-steward to Claude Code?
Run this command in your terminal: claude mcp add sql-steward --env SQL_STEWARD_DB_URL='<SQL_STEWARD_DB_URL>' -- uvx sql-steward
What are the best alternatives to sql-steward?
The closest alternatives to sql-steward are Midplane, PlatypusDB, Lorebase, Sovaria and model2data studio.
Alternatives to sql-steward

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