AM

aaronontheweb/mssql-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

159 stars 23 forks Качество 75 Тренд 16Apache-2.0

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

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",
Открыть полный README на GitHub

Установка

docker run -i --rm -e MSSQL_CONNECTION_STRING mssql-mcp:latest
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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