https://github.com/daobataotie/mssql-mcp

mssql mcp server
https://github.com/daobataotie/mssql-mcp

ai mcp model-context-protocol mssql

Last synced: 8 months ago
JSON representation

mssql mcp server

• Host: GitHub
• URL: https://github.com/daobataotie/mssql-mcp
• Owner: daobataotie
• License: mit
• Created: 2025-03-13T03:48:56.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2025-03-13T03:59:12.000Z (8 months ago)
• Last Synced: 2025-03-13T04:28:36.345Z (8 months ago)
• Topics: ai, mcp, model-context-protocol, mssql
• Language: Python
• Homepage:
• Size: 0 Bytes
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-mcp-servers - **mssql-mcp** - mssql mcp server (Python-based) `python` `ai` `mcp` `model-context-protocol` `mssql` `pip install git+https://github.com/daobataotie/mssql-mcp` (🤖 AI/ML)
• awesome-mcp-servers - **mssql-mcp** - mssql mcp server (Python-based) (actively maintained) `python` `ai` `mcp` `model-context-protocol` `mssql` `pip install git+https://github.com/daobataotie/mssql-mcp` (AI/ML)
• awesome-mcp-servers - MSSQL Insight Server - Provides database interaction, business intelligence, and automated insight memo generation for MSSQL (Table of Contents / Databases)
• awesome-mcp-servers - MSSQL Insight Server - Provides database interaction, business intelligence, and automated insight memo generation for MSSQL (Table of Contents / Databases)
• metorial-index - MSSQL MCP Server - Provides capabilities for database interaction, allowing execution of SQL queries, data analysis, and automatic generation of business insight memos. (Databases)

README

          
# MSSQL MCP Server

[English](/README_en.md) | [中文](/README_zh.md) 

## Overview

MSSQL MCP Server,  provides database interaction and business intelligence capabilities. This server enables running SQL queries, analyzing business data, and automatically generating business insight memos.  

Refer to the official website's SQLite for modifications to adapt to MSSQL

## Components

- `read_query`

   - Execute SELECT queries to read data from the database

- `write_query`

   - Execute INSERT, UPDATE, or DELETE queries

- `create_table`

   - Create new tables in the database

- `list_tables`

   - Get a list of all tables in the database

- `describe-table`

   - View schema information for a specific table

- `append_insight`

   - Add new business insights to the memo resource

## Demo

The database table is as follows. The column names are not standardized, and AI will match them on its own. Errors during SQL execution will self correct.

![Table](imgs/table.png)

The following is the demo.

![Demo](imgs/demo.gif)

   

## Operating environment

- `Python 3.x`

- `Packages`

   - pyodbc>=4.0.39

   - pydantic>=2.0.0

   - mcp>=0.1.0 

- `ODBC Driver 17 for SQL Server`

## Usage 

### Install packages

```bash

CD /d ~/mssql-mcp  

pip install -r requirements.txt  

```

### config

```bash

#with server.py same folder create config.json，add：    

{

    "database": {

        "driver": "ODBC Driver 17 for SQL Server",

        "server": "server ip",

        "database": "db name",

        "username": "username",

        "password": "password",

        "trusted_connection": false

    },

    "server": {

        "name": "mssql-manager",

        "version": "0.1.0",

        "host": "0.0.0.0",

        "port": 8080

    }

}

```

### Claude Desktop 、 Windsurf

```bash

# add to claude_desktop_config.json. Note：use your path  

{

    "mcpServers": {

        "mssql": {

            "command": "py",

            "args": [

                # your path，e.g.："C:\\mssql-mcp\\src\\server.py"

                "~/server.py"

            ]

        }

    }

}

```

### Cursor

```bash

# Add according to the following diagram Cursor MCP. Note：use your path  

```

![Cursor config](imgs/cursor_config.png)

### MCP Inspector

```bash

# Note：use your path  

npx -y @modelcontextprotocol/inspector py C:\\mssql-mcp\\src\\server.py

```

## Project Structure

```

mssql-mcp

├── .git

├── .gitignore

├── LICENSE

├── README.md

├── README_en.md

├── README_zh.md

├── imgs

│   ├── cursor_config.png

│   ├── table.png

│   └── demo.gif

├── requirements.txt

└── src

    ├── __init__.py

    └── server.py

```

## License

MIT License