MCP server de SQL
Commit 21 oct 2026Proporciona una puerta de enlace SQL gobernada para que los agentes de IA accedan a PostgreSQL, MySQL y OceanBase mediante álgebra relacional controlada y políticas de seguridad estrictas.
También conocido como nethinwei/sql-mcp-server, sql-mcp-server
- Stars
- 1
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.1.21
- Último commit
- 21 oct 2026
- Licencia
- MIT
¿Qué es SQL MCP?
SQL es un MCP server. Proporciona una puerta de enlace SQL gobernada para que los agentes de IA accedan a PostgreSQL, MySQL y OceanBase mediante álgebra relacional controlada y políticas de seguridad estrictas.
Resumen generado a partir del README del proyecto
Acerca del MCP server de SQL
La función principal de este servidor es proporcionar una puerta de enlace gobernada para que agentes de IA no confiables interactúen con bases de datos relacionales. Permite a los desarrolladores conectar clientes de IA como Claude Desktop, Cursor o VS Code a instancias de PostgreSQL, MySQL y OceanBase. En lugar de permitir SQL arbitrario, el sistema utiliza álgebra relacional y generación de código parametrizado para garantizar que los agentes solo realicen operaciones deterministas a través de una lista blanca de herramientas controladas.
La seguridad se aplica mediante ACL a nivel de campo, políticas de filas y enmascaramiento, lo que evita la exposición no autorizada de datos. Para operadores de confianza, se puede habilitar un canal de escape específico execute_sql mediante permisos explícitos, aunque permanece desactivado por defecto. El servidor gestiona costes y rendimiento mediante el pre-análisis con EXPLAIN, límites de resultados, tiempos de espera y presupuestos de sesión. El despliegue se realiza mediante Docker Compose o compilaciones manuales con Go, y los administradores pueden gestionar las configuraciones a través de una consola web dedicada.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar SQL MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar SQL MCP en Claude Code
$ claude mcp add --env 'DATABASE_DSN=<YOUR_DATABASE_DSN>' sql-mcp-server -- docker run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21Instalar SQL MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"sql-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nethinwei/sql-mcp-server:0.1.21"
],
"env": {
"DATABASE_DSN": "<YOUR_DATABASE_DSN>"
}
}
}
}Instalar SQL MCP en VS Code
.vscode/mcp.json
{
"servers": {
"sql-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nethinwei/sql-mcp-server:0.1.21"
],
"env": {
"DATABASE_DSN": "<YOUR_DATABASE_DSN>"
}
}
}
}Instalar SQL MCP en VS Code CLI
$ code --add-mcp '{"name":"sql-mcp-server","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/nethinwei/sql-mcp-server:0.1.21"],"env":{"DATABASE_DSN":"<YOUR_DATABASE_DSN>"}}'Instalar SQL MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"sql-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nethinwei/sql-mcp-server:0.1.21"
],
"env": {
"DATABASE_DSN": "<YOUR_DATABASE_DSN>"
}
}
}
}Instalar SQL MCP en Codex
$ codex mcp add sql-mcp-server --env 'DATABASE_DSN=<YOUR_DATABASE_DSN>' -- docker run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21Instalar SQL MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.sql-mcp-server] command = "docker" args = ["run", "-i", "--rm", "ghcr.io/nethinwei/sql-mcp-server:0.1.21"] [mcp_servers.sql-mcp-server.env] DATABASE_DSN = "<YOUR_DATABASE_DSN>"
Instalar SQL MCP en Gemini CLI
$ gemini mcp add -s user -e 'DATABASE_DSN=<YOUR_DATABASE_DSN>' sql-mcp-server docker -- run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21Instalar SQL MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"sql-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nethinwei/sql-mcp-server:0.1.21"
],
"env": {
"DATABASE_DSN": "<YOUR_DATABASE_DSN>"
}
}
}
}Configuración
DATABASE_DSNSecretoDatabase DSN referenced by ${DATABASE_DSN} in config.yaml
| Nombre | Descripción | Tipo |
|---|---|---|
| DATABASE_DSN | Database DSN referenced by ${DATABASE_DSN} in config.yaml | Secreto |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblenethinwei/sql-mcp-server is public and reachablegithub.com/nethinwei/sql-mcp-server ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-21github.com/nethinwei/sql-mcp-server ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubSQL 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
- Cursor、Claude Desktop 和 VS Code 的 stdio 模板:
examples/clients/(核对结论见 客户端接入核对); - 完整配置模板:
examples/config.example.yaml; - CLI、启动、热重载、容器部署和升级:运行与运维;
- Web 管理控制台与 Docker Compose 部署:管理控制台;
- 魔搭分发展示:ModelScope 上架与使用。
按角色阅读
首次体验与集成
- 五分钟快速体验:唯一完整 Demo 与 Inspector 示例;
- 配置参考:公开 YAML 配置的唯一事实源;
- Provider 兼容性与 支持版本:当前能力和验证边界。
部署与安全
- 运行与运维:CLI、容器部署、生命周期、监控和升级;
- 管理控制台:配置编辑、发布回滚、管理员权限与 Docker 部署;
- 安全模型:运行时安全行为的唯一事实源;
- 威胁模型:威胁、控制、测试证据与剩余风险;
- SECURITY.md:漏洞披露流程。
开发与维护
版本与规划
- 当前 GA:
v0.1.21(发布说明); - 全版本摘要:CHANGELOG;历史能力与迁移: 发布说明索引;
- 未发布产品规划:Roadmap;
- 数据库候选:Provider Roadmap。
许可
Preguntas sobre SQL MCP
¿Cómo agrego SQL MCP a Claude Code?
Ejecuta claude mcp add --env 'DATABASE_DSN=<YOUR_DATABASE_DSN>' sql-mcp-server -- docker run -i --rm ghcr.io/nethinwei/sql-mcp-server:0.1.21 en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego SQL MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué bases de datos son compatibles?
El servidor es compatible con PostgreSQL, MySQL y OceanBase.
¿Cómo puede un operador de confianza ejecutar SQL puro?
Los operadores de confianza pueden utilizar un canal de escape SQL independiente llamado execute_sql, que está desactivado por defecto y requiere permisos explícitos.
¿Qué medidas de seguridad existen para el acceso a los datos?
El servidor aplica RBAC, ACL de campos, políticas de filas y enmascaramiento.