McpSqlServer 0.9.2

McpSqlServer

Servidor MCP especialista em SQL Server com autenticação Windows integrada e modo somente leitura por padrão.

Conecte Gemini, Cursor, Claude Desktop ou VS Code ao SQL Server usando o seu usuário de rede — sem credenciais de aplicação.

Repositório: https://github.com/SouzaMatheus-dev/mcp-sqlserver

Instalação

Global tool (.NET 8+)

dotnet tool install --global McpSqlServer
dotnet tool update --global McpSqlServer

dotnet dnx (requer .NET 10 SDK)

dotnet dnx McpSqlServer --yes --source https://api.nuget.org/v3/index.json

Em máquinas corporativas com .NET 8/9, prefira a global tool (mcp-sqlserver).

Configuração MCP

Global tool — Gemini / Cursor

{
  "mcpServers": {
    "sqlserver-hml": {
      "command": "mcp-sqlserver",
      "env": {
        "MCPMSSQL_CONNECTION_STRING": "Server=SQLHML;Integrated Security=SSPI;TrustServerCertificate=True;Database=master",
        "MSSQL_READONLY": "true"
      }
    }
  }
}

dotnet dnx — Gemini

{
  "mcpServers": {
    "sqlserver-hml": {
      "command": "dotnet",
      "args": ["dnx", "McpSqlServer", "--yes", "--source", "https://api.nuget.org/v3/index.json"],
      "env": {
        "MCPMSSQL_CONNECTION_STRING": "Server=SQLHML;Integrated Security=SSPI;TrustServerCertificate=True;Database=master",
        "MSSQL_READONLY": "true"
      }
    }
  }
}

Reinicie o cliente MCP e valide com usuario_conectado.

Um servidor, vários bancos

Configure uma entrada por ambiente (DEV, HML, PROD). Use o parâmetro database nas ferramentas:

listar_bancos()
listar_tabelas(database="Vendas")
executar_consulta(sql="SELECT TOP 10 * FROM dbo.Pedidos", database="Financeiro")

Ferramentas MCP (30)

Conexão e inventário

Metadados e dicionário de dados

Relacionamentos e impacto

Descoberta

Entender os dados

Tuning estrutural (sem DMVs de servidor)

Performance em runtime (opt-in)

Requer MSSQL_ENABLE_PERFORMANCE_DMVS=true — somente consultas_lentas e indices_nao_utilizados.

Procedures não são executadas (EXEC bloqueado). Foco em leitura corporativa.

Fluxo sugerido para devs

1. resumir_banco → visão geral
2. listar_chaves_estrangeiras + listar_indices → entender JOINs
3. buscar_texto_sql / buscar_coluna → achar lógica e campos
4. amostrar_tabela + perfil_coluna → entender os dados
5. listar_fks_sem_indice + analisar_cobertura_indice → tuning estrutural
6. medir_consulta / extrair_sugestoes_plano → validar e propor índices
7. listar_dependencias → avaliar impacto de mudanças
8. (opt-in) consultas_lentas / indices_nao_utilizados → runtime em produção

Variáveis de ambiente

Segurança

• Autenticação via usuário de rede (Integrated Security=SSPI)
• Validador SQL bloqueia comandos de escrita
• Permissões reais vêm do SQL Server — o MCP não eleva privilégios
• Mantenha MSSQL_READONLY=true em produção

Documentação completa

• Instalação: https://github.com/SouzaMatheus-dev/mcp-sqlserver/blob/main/docs/instalacao.md
• Configuração MCP: https://github.com/SouzaMatheus-dev/mcp-sqlserver/blob/main/docs/configuracao-mcp.md
• Exemplos de uso: https://github.com/SouzaMatheus-dev/mcp-sqlserver/blob/main/docs/exemplos-uso.md

Licença

MIT