Sql Server Mcp

by hendrickcastro

252 downloads
Not rated
GitHub

About

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.

Details

Author
hendrickcastro
Downloads
252
Categories
Database

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Sql Server Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "sql server mcp": {
            "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"
                }
            }
        }
    }
}

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"
        }
    }
}

MCPQL - SQL Server MCP Server

License: MIT
Node.js Version
TypeScript
npm version
Downloads
GitHub stars
GitHub issues
GitHub forks
Build Status
Coverage Status
SQL Server
Azure SQL
MCP Protocol
Claude Desktop
Cursor IDE
Docker
Security
Maintenance

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.

🚀 Quick Start

Prerequisites

- Node.js 18+ and npm - SQL Server database with appropriate connection credentials - MCP-compatible client (like Claude Desktop, Cursor IDE, or any MCP client)

Installation & Configuration

Option 1: Using npx from GitHub (Recommended)

No installation needed! Just configure your MCP client:

For Claude Desktop (claude_desktop_config.json):

{
"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"
}
}
}
}

For Cursor IDE:

{
"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"
}
}
}
}

Option 2: Local Development Installation

1. Clone and setup:

git clone https://github.com/hendrickcastro/MCPQL.git
cd MCPQL
npm install
npm run build

2. Configure database connection:
Create a .env file with your database credentials:
```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.