Skip to main content
Glama

@yuuzu/sql-mcp

CI npm version

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-mcp

Related 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

connect-database

Conectarse a un servidor de base de datos

disconnect

Desconectarse de la conexión actual

connection-status

Comprobar el estado de la conexión y el modo de consulta

list-databases

Listar todas las bases de datos en el servidor

switch-database

Cambiar a una base de datos diferente

list-tables

Listar todas las tablas y vistas

describe-table

Obtener detalles del esquema de la tabla

execute-query

Ejecutar consultas SQL

Modos de consulta

Controle los permisos de consulta mediante la variable de entorno SQL_MCP_MODE:

Modo

Operaciones permitidas

Descripción

safe (predeterminado)

SELECT, WITH, EXPLAIN

Solo lectura, el más seguro

write

+ INSERT, UPDATE, DELETE

Permite la modificación de datos

full

+ 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, incluido safe, ya que son consultas de metadatos de solo lectura utilizadas habitualmente con SQLite.

# Example: Enable write mode
SQL_MCP_MODE=write bunx @yuuzu/sql-mcp

Ejemplos 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 mediante bunx, MSSQL y PostgreSQL funcionan normalmente, pero las conexiones a SQLite devolverán un error claro indicándole que utilice npx o node en 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 typecheck

Lanzamiento

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.0

Esto hará lo siguiente:

  1. Compilar el proyecto

  2. Publicar en npm con procedencia

  3. 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

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
4wRelease cycle
4Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    A 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.
    1
    381
    MIT
  • F
    license
    -
    quality
    D
    maintenance
    A 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
  • F
    license
    -
    quality
    D
    maintenance
    A 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.
  • F
    license
    -
    quality
    C
    maintenance
    A 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.

View all related MCP servers

Related MCP Connectors

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • MCP server for managing Prisma Postgres.

  • A Model Context Protocol server for Wix AI tools

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/NakiriYuuzu/sql-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server