# SQL Safe MCP server

> Provides coding agents with read-only SQL schema knowledge and PII-safe query capabilities for SQL Server, MySQL, and MariaDB.

- Repository: https://github.com/proprock/sql-safe-mcp
- Page: https://hostedmcp.org/servers/proprock/sql-safe-mcp
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 2.0.0

## Install

### Claude Code

```sh
claude mcp add sql-safe-mcp -- uvx sql-safe-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "sql-safe-mcp": {
      "command": "uvx",
      "args": [
        "sql-safe-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "sql-safe-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "sql-safe-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"sql-safe-mcp","type":"stdio","command":"uvx","args":["sql-safe-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "sql-safe-mcp": {
      "command": "uvx",
      "args": [
        "sql-safe-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add sql-safe-mcp -- uvx sql-safe-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.sql-safe-mcp]
command = "uvx"
args = ["sql-safe-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user sql-safe-mcp uvx -- sql-safe-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "sql-safe-mcp": {
      "command": "uvx",
      "args": [
        "sql-safe-mcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `REPORTING_SQL_URL` | no | no |  |
| `SQL_SAFE_MCP_CONFIG` | no | no |  |

## FAQ

### What databases does this server support?

The server supports SQL Server, MySQL, and MariaDB.

### How does the server protect PII data?

Configured PII columns are returned as alias-bound, authenticated tokens instead of plaintext, allowing agents to filter or count without seeing the actual data.

### Can I connect to multiple databases at once?

Yes, a single MCP process can expose multiple named instances with isolated policies and connections.