mssql-mcp MCP Server

A .NET-powered Model Context Protocol (MCP) server for Microsoft SQL Server.

Local serverstdio

What is the mssql-mcp Server?

mssql-mcp is an MCP project maintained in the aaronontheweb/mssql-mcp repository. The maintainer describes its purpose as “A .NET-powered Model Context Protocol (MCP) server for Microsoft SQL Server”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using docker. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares MSSQL_CONNECTION_STRING. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
execute_sqlExecute any SQL query against the database
list_tablesList all tables with schema, name, type, and row count
list_schemasList all available schemas/databases in the SQL Server instance

How to install the mssql-mcp Server

{
  "mcpServers": {
    "mssql": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MSSQL_CONNECTION_STRING",
        "mssql-mcp:latest"
      ],
      "env": {
        "MSSQL_CONNECTION_STRING": "Server=host.docker.internal,1533; Database=MyDb; User Id=myUser; Password=My(!)Password;TrustServerCertificate=true;"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
MSSQL_CONNECTION_STRINGDeclared in the maintainer’s client configuration.Check documentation