SQL Server Reviewer MCP 🔍

Un servidor MCP (Model Context Protocol) de solo lectura para SQL Server. Permite que clientes IA como Claude Desktop, Cursor o cualquier cliente MCP compatible analicen esquemas, dependencias, procedimientos almacenados e índices faltantes de tu base de datos — sin riesgo de modificar nada.

⚡ Características

• 9 herramientas de análisis listas para usar
• Solo lectura — no ejecuta DDL ni DML, solo consultas a vistas de sistema
• Queries parametrizadas — protección contra inyección SQL
• Comunicación stdio — JSON-RPC 2.0 vía stdin/stdout
• Logging seguro — Serilog escribe solo a archivos, nunca a stdout

🛠️ Herramientas Disponibles

| Herramienta | Descripción | |---|---| | list_tables | Lista todas las tablas con filas aproximadas y espacio | | analyze_table_schema | Columnas, tipos, PKs, FKs e índices de una tabla | | get_sp_definition | Código fuente de un procedimiento almacenado | | list_stored_procedures | Catálogo de todos los SPs | | get_function_definition | Código fuente de una función | | find_object_dependencies | Qué objetos referencia y quién lo referencia | | search_in_code | Buscar texto en el código de todos los objetos | | get_missing_indexes | Índices faltantes sugeridos por el motor (DMVs) | | get_table_relationships | Mapa de foreign keys |

📋 Requisitos

• .NET 8 SDK o superior
• Acceso a una instancia de SQL Server
• Un usuario SQL con permisos de solo lectura (recomendado: db_datareader + VIEW DEFINITION)

🚀 Instalación

Opción A: Descargar binario (recomendado)

Descarga el ejecutable para tu plataforma desde Releases:

• sql-server-reviewer-mcp-win-x64.zip — Windows
• sql-server-reviewer-mcp-linux-x64.tar.gz — Linux
• sql-server-reviewer-mcp-osx-x64.tar.gz — macOS

Estos son self-contained — no necesitas .NET instalado.

Opción B: Compilar desde fuente

git clone https://github.com/EmilianoRojas/sql-server-reviewer-mcp.git
cd sql-server-reviewer-mcp/SqlServerMcp
dotnet publish -c Release -o ./publish

Opción C: Docker

docker build -t sql-server-reviewer-mcp .

Verificar

# Linux/macOS
./publish/SqlServerMcp

# Windows
.\publish\SqlServerMcp.exe

El proceso esperará input en stdin. Si se queda esperando, funciona correctamente. Cierra con Ctrl+C.

⚙️ Configuración

La conexión a SQL Server se configura mediante la variable de entorno SQLSERVER_CONNECTION_STRING.

Formato de la cadena de conexión

Server=tu-servidor;Database=tu-base;User Id=tu-usuario;Password=tu-password;TrustServerCertificate=True;

Para Windows Authentication:

Server=tu-servidor;Database=tu-base;Integrated Security=True;TrustServerCertificate=True;

🔌 Integración con Clientes MCP

Claude Desktop

Edita tu archivo de configuración (claude_desktop_config.json):

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sql-server-reviewer": {
      "command": "dotnet",
      "args": ["run", "--project", "C:/ruta/a/sql-server-reviewer-mcp/SqlServerMcp"],
      "env": {
        "SQLSERVER_CONNECTION_STRING": "Server=localhost;Database=MiBase;User Id=reader;Password=secret;TrustServerCertificate=True;"
      }
    }
  }
}

O usando el ejecutable publicado:

{
  "mcpServers": {
    "sql-server-reviewer": {
      "command": "C:/ruta/a/sql-server-reviewer-mcp/SqlServerMc

... [View full README on GitHub](https://github.com/EmilianoRojas/sql-server-reviewer-mcp#readme)