Sql Server Mcp

Name: Sql Server Mcp
Author: hendrickcastro

@hendrickcastro

About Sql Server Mcp

A comprehensive Model Context Protocol (MCP) server for SQL Server database operations. This server provides 10 powerful tools for database analysis, object discovery, and data manipulation through the MCP protocol.

#mcp #modelcontextprotocol #sqlserver #azuresql #database #databaseanalysis #databasetools #mssql #tsql

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcpql": {
      "command": "npx",
      "args": [
        "-y",
        "hendrickcastro/mcpql"
      ],
      "env": {
        "DB_AUTHENTICATION_TYPE": "sql",
        "DB_SERVER": "your_server",
        "DB_NAME": "your_database",
        "DB_USER": "your_username",
        "DB_PASSWORD": "your_password",
        "DB_PORT": "1433",
        "DB_ENCRYPT": "false",
        "DB_TRUST_SERVER_CERTIFICATE": "true"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Sql Server Mcp?

Sql Server Mcp is a comprehensive Model Context Protocol (MCP) server for SQL Server database operations. It provides 10 tools for database analysis, object discovery, and data manipulation through the MCP protocol. The server is designed for developers and DBAs using MCP-compatible clients like Claude Desktop or Cursor IDE.

How to use Sql Server Mcp?

Installation is recommended via npx with no local setup required. Configure your MCP client (e.g., Claude Desktop or Cursor IDE) with the command npx -y hendrickcastro/mcpql and set the required environment variables for database connection. Alternatively, clone the repository, run npm install and npm run build, then point your MCP client to the built server file.

Key features of Sql Server Mcp

10 dedicated MCP tools for SQL Server operations
Supports SQL Server, SQL Server Express, and Azure SQL
SQL, Windows, and Azure AD authentication
Connection pooling and comprehensive timeout settings
Docker-ready and security audited
Configurable via environment variables or connection string

Use cases of Sql Server Mcp

Analyze table structures, indexes, and constraints via MCP tools
Execute custom SQL queries and stored procedures with parameters
Search database objects by name and definition across the entire database
Preview data and get column statistics for quick analysis
Discover object dependencies for tables, views, and procedures

FAQ from Sql Server Mcp

What databases does Sql Server Mcp support?

It supports SQL Server 2016+, SQL Server Express (named instances), and Azure SQL Database.

What authentication types are available?

Sql Server Mcp supports SQL Server Authentication, Windows Authentication, and Azure Active Directory Authentication (including service principals).

Do I need to install anything locally to use Sql Server Mcp?

No. You can use npx -y hendrickcastro/mcpql directly – no local installation required.

What are the required environment variables?

At minimum, you must set DB_AUTHENTICATION_TYPE, DB_SERVER, and DB_NAME. For SQL auth, also set DB_USER and DB_PASSWORD. See the README for the full variable table.

How is data privacy handled?

The server connects directly to your SQL Server instance; data stays on your database. All configuration is done through environment variables or a connection string.