Microsoft SQL Server MCP Server

A Model Context Protocol (MCP) server for secure SQL Server database access through Claude Desktop.

Features

• 🔍 List database tables
• 📊 Execute SQL queries (SELECT, INSERT, UPDATE, DELETE)
• 🔐 Multiple authentication methods (SQL, Windows, Azure AD)
• 🏢 LocalDB and Azure SQL support
• 🔌 Custom port configuration

Quick Start

Install with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mssql": {
      "command": "uvx",
      "args": ["yulin-mssql-mcp"],
      "env": {
        "MSSQL_SERVER": "localhost",
        "MSSQL_DATABASE": "your_database",
        "MSSQL_USER": "your_username",
        "MSSQL_PASSWORD": "your_password"
      }
    }
  }
}

Configuration

Basic SQL Authentication

MSSQL_SERVER=localhost          # Required
MSSQL_DATABASE=your_database    # Required
MSSQL_USER=your_username        # Required for SQL auth
MSSQL_PASSWORD=your_password    # Required for SQL auth

Windows Authentication

MSSQL_SERVER=localhost
MSSQL_DATABASE=your_database
MSSQL_WINDOWS_AUTH=true         # Use Windows credentials

Azure SQL Database

MSSQL_SERVER=your-server.database.windows.net
MSSQL_DATABASE=your_database
MSSQL_USER=your_username
MSSQL_PASSWORD=your_password
# Encryption is automatic for Azure

Optional Settings

MSSQL_PORT=1433                 # Custom port (default: 1433)
MSSQL_ENCRYPT=true              # Force encryption
MCP_DEBUG=1                     # Enable debug logging to stderr

Alternative Installation Methods

Using pip

pip install yulin-mssql-mcp

Then in claude_desktop_config.json:

{
  "mcpServers": {
    "mssql": {
      "command": "yulin-mssql-mcp",
      "args": [],
      "env": { ... }
    }
  }
}

Development

git clone https://github.com/yulin0629/mssql_mcp_server.git
cd mssql_mcp_server
pip install -e .

Debugging

Enable debug mode to see detailed logs in stderr:

# Set environment variable
MCP_DEBUG=1

# Or in Claude Desktop config
"env": {
  "MCP_DEBUG": "1",
  ...
}

Debug logs include:

• Database connection details (without passwords)
• SQL query execution traces
• MCP protocol message flow

Security

• Create a dedicated SQL user with minimal permissions
• Never use admin/sa accounts
• Use Windows Authentication when possible
• Enable encryption for sensitive data

License

MIT