SQL MCP Server

by nethinweiio.github.nethinwei/sql-mcp-serverv0.1.11

Controlled SQL access gateway with policy, cost limits, tenant isolation, and safe tools.

0Dockerstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install SQL MCP server

claude mcp add sql-nethinwei -e DATABASE_DSN='<database-dsn>' -- docker run -i --rm -e DATABASE_DSN ghcr.io/nethinwei/sql-mcp-server:0.1.11 serve --config /config/config.yaml --transport stdio

{
  "mcpServers": {
    "sql-nethinwei": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_DSN",
        "ghcr.io/nethinwei/sql-mcp-server:0.1.11",
        "serve",
        "--config",
        "/config/config.yaml",
        "--transport",
        "stdio"
      ],
      "env": {
        "DATABASE_DSN": "<database-dsn>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "sql-nethinwei": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_DSN",
        "ghcr.io/nethinwei/sql-mcp-server:0.1.11",
        "serve",
        "--config",
        "/config/config.yaml",
        "--transport",
        "stdio"
      ],
      "env": {
        "DATABASE_DSN": "<database-dsn>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "sql-nethinwei": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_DSN",
        "ghcr.io/nethinwei/sql-mcp-server:0.1.11",
        "serve",
        "--config",
        "/config/config.yaml",
        "--transport",
        "stdio"
      ],
      "env": {
        "DATABASE_DSN": "<database-dsn>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "sql-nethinwei": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_DSN",
        "ghcr.io/nethinwei/sql-mcp-server:0.1.11",
        "serve",
        "--config",
        "/config/config.yaml",
        "--transport",
        "stdio"
      ],
      "env": {
        "DATABASE_DSN": "<database-dsn>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
DATABASE_DSN	—	yes	Database DSN referenced by ${DATABASE_DSN} in config.yaml

Freshness

Active — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-10-08 · 1d ago · GitHub · v0.1.11
Package published
no data · npm/PyPI
Registry entry updated
2026-10-08 · 1d ago · official registry · v0.1.11

FAQ

›How do I install the SQL MCP server in Claude Code?

Run: claude mcp add sql-nethinwei -e DATABASE_DSN='<database-dsn>' -- docker run -i --rm -e DATABASE_DSN ghcr.io/nethinwei/sql-mcp-server:0.1.11 serve --config /config/config.yaml --transport stdio. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does SQL require an API key?

Yes. It expects DATABASE_DSN, of which 1 is a secret.

›Can I use SQL as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is SQL in the official MCP registry?

Yes, as io.github.nethinwei/sql-mcp-server.