
aaronontheweb/mssql-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
aaronontheweb/mssql-mcp — это кандидат для MCP-сервера, импортированный из https://github.com/aaronontheweb/mssql-mcp.
Обзор
aaronontheweb/mssql-mcp — это кандидат для MCP-сервера, импортированный из https://github.com/aaronontheweb/mssql-mcp.
Обзор (машинный перевод)
A. Сервер Model Context Protocol (MCP) на базе NET для Microsoft SQL Server.
Аннотация
Почему это вообще существует? Потому что другие MCP-решения на рынке — это обычно неудобные вещи, которые не работают — уж точно не на Windows.
Этот MCP-сервер предоставляет агентам ИИ надёжный и надёжный доступ к базам данных Microsoft SQL Server через чистое, хорошо спроектированное .NET-приложение, использующее Akka.NET для внутренней координации и официальный MCP C# SDK для соответствия протоколам.
Особенности
- Обнаружение схемы: ИИ-агенты могут исследовать структуру базы данных без написания сложного SQL
- Выполнение запросов: Полная поддержка SQL для операций SELECT, INSERT, UPDATE, DELETE и DDL
- Проверка соединения: Автоматическая проверка подключения к базе данных при запуске
- Обработка ошибок: Комплексная обработка ошибок с чёткими, оперативными сообщениями об ошибках
- Форматирование таблицы: результаты запросов, отформатированных в читаемых таблицах для использования ИИ
- Docker Support: Простое развертывание с встроенными инструментами .NET Docker
Доступные инструменты
| Инструмент | Описание |
|---|---|
execute_sql |
Выполнить любой SQL-запрос к базе данных |
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
mssql-mcp
A .NET-powered Model Context Protocol (MCP) server for Microsoft SQL Server.
Abstract
Why does this exist? Because the other MCP solutions in market for this are generally janky pieces of shit that don’t work - certainly not on Windows.
This MCP server provides AI agents with robust, reliable access to Microsoft SQL Server databases through a clean, well-architected .NET application using Akka.NET for internal coordination and the official MCP C# SDK for protocol compliance.
Features
- Schema Discovery: AI agents can explore database structure without writing complex SQL
- Query Execution: Full SQL support for SELECT, INSERT, UPDATE, DELETE, and DDL operations
- Connection Validation: Automatic database connectivity validation on startup
- Error Handling: Comprehensive error handling with clear, actionable error messages
- Table Formatting: Query results formatted in readable tables for AI consumption
- Docker Support: Easy deployment with built-in .NET Docker tooling
Available Tools
| Tool | Description |
|---|---|
execute_sql |
Execute any SQL query against the database |
list_tables |
List all tables with schema, name, type, and row count |
list_schemas |
List all available schemas/databases in the SQL Server instance |
Configuration
Required Environment Variables
The MCP server requires a single environment variable:
MSSQL_CONNECTION_STRING: Complete SQL Server connection string
Example Connection Strings
Windows Authentication:
MSSQL_CONNECTION_STRING="Server=localhost;Database=MyDatabase;Trusted_Connection=true;"
SQL Server Authentication:
MSSQL_CONNECTION_STRING="Server=localhost;Database=MyDatabase;User Id=myuser;Password=mypassword;"
Azure SQL Database:
MSSQL_CONNECTION_STRING="Server=myserver.database.windows.net;Database=mydatabase;User Id=myuser;Password=mypassword;Encrypt=true;"
Running the MCP Server
Option 1: Docker (Recommended)
The easiest way to run the MCP server is using Docker with .NET’s built-in container support.
Build and Run with Docker
Clone the repository
# Clone the repository
git clone https://github.com/Aaronontheweb/mssql-mcp.git
cd mssql-mcp
Build the Docker image
dotnet publish --os linux --arch x64 /t:PublishContainer
You can run the container directly if you wish, but it’s probably best to let the MCP server spin up the client:
# Run the container
docker run -it --rm \
-e MSSQL_CONNECTION_STRING="Server=host.docker.internal;Database=MyDB;Trusted_Connection=true;" \
mssql-mcp:latest
MCP Client Configuration
Cursor IDE
Add to your Cursor settings (Cursor Settings > Features > Model Context Protocol):
{
"mcpServers": {
"mssql": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MSSQL_CONNECTION_STRING",
Установка
docker run -i --rm -e MSSQL_CONNECTION_STRING mssql-mcp:latestКонфигурация
{
"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;"
}
}
}
}