Mcp Sql Server

by ryudg

363 downloads Not rated yet

GitHub Website

Database

About

A Model Context Protocol server that provides comprehensive access to SQL databases, starting with MSSQL support. It enables AI assistants to inspect database schemas, execute queries, and perform database operations with enterprise‑grade security and performance monitoring.

Explore

video1
video2
video3

- Database Support: Full MSSQL support (MySQL and PostgreSQL coming soon)
- Schema Inspection: Comprehensive database structure analysis and metadata
extraction
- Query Execution: Safe SQL execution with parameterized queries and result
formatting
- Performance Monitoring: Real-time metrics, query statistics, and
performance reports
- Security First: SQL injection prevention, connection encryption, and
access controls
- Batch Operations: Efficient bulk query execution and transaction
management
- Connection Pooling: Optimized connection management with configurable pool
settings
- MCP Integration: Native support for Claude Desktop, Cursor, and other
MCP-compatible tools

- 🔮 Multi-Database Support

- MySQL adapter implementation
- PostgreSQL adapter implementation
- Unified database interface

- ⚡ Performance & Caching

- Query result caching system
- Advanced performance optimization
- Connection pool enhancements

- 🧪 Testing & Quality

- Comprehensive test coverage (100%)
- Automated CI/CD pipeline
- Performance benchmarking

- 🚀 Advanced Features

- GraphQL integration support
- Enhanced monitoring dashboard
- Plugin architecture for extensibility

- 📊 Analytics & Insights
- Advanced query analytics
- Database performance insights
- Usage statistics and reporting

View CHANGELOG

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:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Mcp Sql Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

From the repository

Prerequisites

- Node.js 18.0.0+ - Download here
- Database Server: Microsoft SQL Server (MSSQL)
- AI Assistant: Claude Desktop, Cursor, or any MCP-compatible tool

> Note: Currently only MSSQL is supported. MySQL and PostgreSQL support will
> be added in future releases.

`list_tables`

List all tables in database

`describe_table`

Get detailed table structure

`get_schema`

Get complete database schema

`get_schema_statistics`

Get schema statistics information

`execute_query`

Execute SQL queries safely

`start_batch_processing`

Process multiple queries in batch

`get_connection_pool_status`

Get database connection pool status

`get_query_stats`

Get query execution statistics

`start_performance_monitoring`

Start performance monitoring

`generate_performance_report`

Generate performance analysis report

`clear_caches`

Initialize cache data

The MCP SQL server provides the following tools for database interaction:

| Tool | Description | Parameters |
| ----------------------- | --------------------------------- | ---------------------------------------------- |
| list_tables | List all tables in database | pattern (optional): Filter pattern |
| describe_table | Get detailed table structure | table_name: Name of table to describe |
| get_schema | Get complete database schema | include_system_tables: Include system tables |
| get_schema_statistics | Get schema statistics information | None |

| Tool | Description | Parameters |
| ------------------------ | --------------------------------- | ------------------------------------------------------- |
| execute_query | Execute SQL queries safely | query: SQL statement<br>parameters: Bind parameters |
| start_batch_processing | Process multiple queries in batch | queries: Array of SQL statements |

| Tool | Description | Parameters |
| ------------------------------ | ------------------------------------ | ------------------------------------ |
| get_connection_pool_status | Get database connection pool status | None |
| get_query_stats | Get query execution statistics | period: Time period (optional) |
| start_performance_monitoring | Start performance monitoring | interval: Monitoring interval (ms) |
| generate_performance_report | Generate performance analysis report | timeRange: Report period |
| clear_caches | Initialize cache data | None |

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "mcp sql server": {
            "mcp-sql": {
                "command": "npx",
                "args": [
                    "-y",
                    "@donggyunryu/mcp-sql"
                ],
                "env": {
                    "DB_HOST": "<localhost>",
                    "DB_PORT": "1433",
                    "DB_DATABASE": "<your_database>",
                    "DB_USER": "<your_username>",
                    "DB_PASSWORD": "<your_password>",
                    "DB_ENCRYPT": "false",
                    "DB_TRUST_SERVER_CERTIFICATE": "true"
                }
            }
        }
    }
}

McpServers

{
    "mcp-sql": {
        "command": "npx",
        "args": [
            "-y",
            "@donggyunryu/mcp-sql"
        ],
        "env": {
            "DB_HOST": "<localhost>",
            "DB_PORT": "1433",
            "DB_DATABASE": "<your_database>",
            "DB_USER": "<your_username>",
            "DB_PASSWORD": "<your_password>",
            "DB_ENCRYPT": "false",
            "DB_TRUST_SERVER_CERTIFICATE": "true"
        }
    }
}

A Model Context Protocol server that provides comprehensive access to SQL
databases, starting with MSSQL support. This server enables AI assistants to
inspect database schemas, execute queries, and perform database operations with
enterprise-grade security and performance monitoring.

Current Status: MSSQL fully supported. _MySQL and PostgreSQL support coming_
in future releases.

✨ Key Features

video1
video2
video3

📦 Installation & Setup

Prerequisites

- Node.js 18.0.0+ - Download here
- Database Server: Microsoft SQL Server (MSSQL)
- AI Assistant: Claude Desktop, Cursor, or any MCP-compatible tool

> Note: Currently only MSSQL is supported. MySQL and PostgreSQL support will
> be added in future releases.

Quick Installation

```bash

No reviews yet — be the first

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

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

Prerequisites

list_tables

describe_table

get_schema

get_schema_statistics

execute_query

start_batch_processing

get_connection_pool_status

get_query_stats

start_performance_monitoring

generate_performance_report

clear_caches

Claude Desktop / Cursor

McpServers

✨ Key Features

📦 Installation & Setup

Prerequisites

Quick Installation

More like this

Redis

Sqlite

PostgreSQL

Npx Y convex@latest mcp start

`list_tables`

`describe_table`

`get_schema`

`get_schema_statistics`

`execute_query`

`start_batch_processing`

`get_connection_pool_status`

`get_query_stats`

`start_performance_monitoring`

`generate_performance_report`

`clear_caches`