English Français العربية

SQL MCP Server

Registre officiel Données et bases de données

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

OCI package ghcr.io/nethinwei/sql-mcp-server:0.1.21
Claude Code 
claude mcp add sql-mcp-server -e 'DATABASE_DSN=<your database_dsn>' -- docker run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21 serve --config /config/config.yaml --transport stdio
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "sql-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/nethinwei/sql-mcp-server:0.1.21",
                "serve",
                "--config",
                "/config/config.yaml",
                "--transport",
                "stdio"
            ],
            "env": {
                "DATABASE_DSN": "<your database_dsn>"
            }
        }
    }
}

Variables d'environnement

  • DATABASE_DSN secret Database DSN referenced by ${DATABASE_DSN} in config.yaml

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. SQL MCP Server
  2. 核心差异
  3. 五分钟体验
  4. 安装与接入
  5. 按角色阅读
  6. 许可

SQL MCP Server

The governed SQL gateway for untrusted AI agents.

面向不可信 AI Agent 的受控 SQL 数据访问网关。通过显式 Entity、关系代数 IR 和 参数化 codegen 访问 PostgreSQL、MySQL 与 OceanBase，受治理面不接受任意 SQL，不提供 DDL。可信操作者另有独立的 SQL 逃生通道 execute_sql：默认关闭，只对被显式授予 sql:execute@<数据源> 的用户可见，走单独声明的连接，受硬上限与写入失败即拒绝的 审计约束（见安全模型）。

核心差异

  • 确定性执行：Agent 只能组合受控工具和白名单 IR；
  • 字段与行治理：RBAC、字段 ACL、row policy 和 mask 统一强制；
  • 成本可控：EXPLAIN 预筛、结果上限、超时和 session/tenant 预算；
  • 默认拒绝：安全能力无法证明时 fail closed；
  • 可审计：配置热重载、异步审计和 OpenTelemetry hook。

运行时安全行为以安全模型为准；Provider 验证边界与证据层级 以兼容矩阵为准；威胁、控制与剩余风险见 威胁模型。所有对外声明的证据汇总见 架构、安全边界与证据索引。不以本页摘要为准。

五分钟体验

只需 Docker 与 Docker Compose：

docker compose -f examples/quickstart/compose.yaml up -d --wait
curl -fsS http://127.0.0.1:8080/healthz

完整的 MCP Inspector 调用、tenant 隔离、mask 和拒绝场景见 五分钟快速体验。

安装与接入

源码构建要求 Go 1.26.10+ 和一个已验证数据库版本：

git clone https://github.com/nethinwei/sql-mcp-server.git
cd sql-mcp-server
make build

按角色阅读

首次体验与集成
部署与安全
开发与维护
版本与规划

许可

MIT

Questions fréquentes

Qu'est-ce que SQL MCP Server ?

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

Comment installer SQL MCP Server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add sql-mcp-server -e 'DATABASE_DSN=<your database_dsn>' -- docker run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21 serve --config /config/config.yaml --transport stdio. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour SQL MCP Server ?

Oui. Il attend DATABASE_DSN, à renseigner dans sa configuration.

SQL MCP Server est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient SQL MCP Server ?

Il est publié par nethinwei. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.