sql-mcp
@yuuzu/sql-mcp
Un servidor del Protocolo de Contexto de Modelo (MCP) para operaciones con bases de datos MSSQL, PostgreSQL y SQLite.
Instalación
# Using bunx (recommended)
bunx @yuuzu/sql-mcp
# Using npx
npx @yuuzu/sql-mcpRelated MCP server: Database MCP Server
Características
Soporte para múltiples bases de datos: MSSQL, PostgreSQL y SQLite (vía better-sqlite3)
8 herramientas para operaciones de base de datos
Tres modos de consulta: safe, write, full
Autenticación avanzada: Windows Auth (MSSQL), certificados SSL (PostgreSQL)
Herramientas
Herramienta | Descripción |
| Conectarse a un servidor de base de datos |
| Desconectarse de la conexión actual |
| Comprobar el estado de la conexión y el modo de consulta |
| Listar todas las bases de datos en el servidor |
| Cambiar a una base de datos diferente |
| Listar todas las tablas y vistas |
| Obtener detalles del esquema de la tabla |
| Ejecutar consultas SQL |
Modos de consulta
Controle los permisos de consulta mediante la variable de entorno SQL_MCP_MODE:
Modo | Operaciones permitidas | Descripción |
| SELECT, WITH, EXPLAIN | Solo lectura, el más seguro |
| + INSERT, UPDATE, DELETE | Permite la modificación de datos |
| + CREATE, DROP, ALTER, TRUNCATE | Acceso total, usar con precaución |
Nota: Las sentencias
PRAGMA(p. ej.PRAGMA table_info(users)) están permitidas en todos los modos, incluidosafe, ya que son consultas de metadatos de solo lectura utilizadas habitualmente con SQLite.
# Example: Enable write mode
SQL_MCP_MODE=write bunx @yuuzu/sql-mcpEjemplos de uso
Configuración de Claude Desktop
Añadir a su claude_desktop_config.json:
{
"mcpServers": {
"sql-mcp": {
"command": "bunx",
"args": ["@yuuzu/sql-mcp"],
"env": {
"SQL_MCP_MODE": "safe"
}
}
}
}Conectarse a MSSQL
{
"tool": "connect-database",
"arguments": {
"engine": "mssql",
"server": "localhost",
"port": 1433,
"user": "sa",
"password": "your_password",
"database": "master"
}
}Conectarse a PostgreSQL
{
"tool": "connect-database",
"arguments": {
"engine": "postgres",
"server": "localhost",
"port": 5432,
"user": "postgres",
"password": "your_password",
"database": "postgres"
}
}Conectarse con autenticación de Windows (MSSQL)
{
"tool": "connect-database",
"arguments": {
"engine": "mssql",
"server": "localhost",
"windowsAuth": true
}
}Conectarse con SSL (PostgreSQL)
{
"tool": "connect-database",
"arguments": {
"engine": "postgres",
"server": "your-server.com",
"user": "postgres",
"password": "your_password",
"ssl": {
"rejectUnauthorized": true,
"ca": "/path/to/ca-certificate.crt"
}
}
}Conectarse a SQLite (archivo)
{
"tool": "connect-database",
"arguments": {
"engine": "sqlite",
"filename": "/absolute/path/to/database.db"
}
}Conectarse a SQLite (en memoria)
Útil para pruebas, demostraciones o espacios de trabajo temporales.
{
"tool": "connect-database",
"arguments": {
"engine": "sqlite",
"filename": ":memory:"
}
}Conectarse a SQLite (solo lectura)
{
"tool": "connect-database",
"arguments": {
"engine": "sqlite",
"filename": "/absolute/path/to/database.db",
"readonly": true,
"fileMustExist": true
}
}Nota de tiempo de ejecución de SQLite: El soporte de SQLite utiliza
better-sqlite3, que requiere Node.js. Al ejecutar mediantebunx, MSSQL y PostgreSQL funcionan normalmente, pero las conexiones a SQLite devolverán un error claro indicándole que utilicenpxonodeen su lugar.
Desarrollo
# Install dependencies
bun install
# Run in development mode
bun run dev
# Run tests
bun test
# Run tests with coverage
bun test --coverage
# Build
bun run build
# Type check
bun run typecheckLanzamiento
Los lanzamientos están automatizados mediante GitHub Actions. Para crear un nuevo lanzamiento:
# Create and push a version tag
git tag v1.0.0
git push origin v1.0.0Esto hará lo siguiente:
Compilar el proyecto
Publicar en npm con procedencia
Crear un lanzamiento en GitHub con notas de lanzamiento generadas automáticamente
Requisitos: Establecer el secreto NPM_TOKEN en la configuración de su repositorio de GitHub.
Licencia
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Draxlr's remote MCP server connects AI assistants to your SQL databases and dashboards. Explore schemas, run read-only queries, manage saved queries and dashboards, and export results, all with row-level security so each user sees only their own data.
Text-to-SQL MCP server: read-only queries on PostgreSQL, MySQL and SQL Server with your real schema
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Related MCP Servers
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables secure interaction with Microsoft SQL Server databases, allowing AI assistants to list tables, read data, and execute SQL queries through a controlled interface.101394MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides tools for connecting to and interacting with various database systems (SQLite, PostgreSQL, MySQL/MariaDB, SQL Server) through a unified interface.3-

MCP TapData Serverofficial
FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables Large Language Models to access and interact with database connections, including viewing schemas and performing CRUD operations on connected databases.-- FlicenseNot gradedqualityCmaintenanceA Model Context Protocol server that allows Large Language Models like Claude to execute SQL queries, explore database schemas, and maintain persistent connections to SQL Server databases.-