金大哥 - mssql-mcp MCP 详情

article

README

🚀 MSSQL MCP 服务器

MSSQL MCP 服务器提供了数据库交互和商业智能功能，能够运行 SQL 查询、分析业务数据，并自动生成商业洞察备忘录，帮助用户更好地处理和理解数据。

🚀 快速开始

MSSQL MCP Server 提供数据库交互和商业智能功能。此服务器支持运行 SQL 查询、分析业务数据，并自动生成商业洞察备忘录。参考官方文档中的 SQLite 修改说明，以适应 MSSQL 环境。

✨ 主要特性

数据读取：通过 read_query 执行 SELECT 查询，轻松读取数据库中的数据。
数据写入：利用 write_query 执行 INSERT、UPDATE 或 DELETE 操作，实现数据的增删改。
表管理：使用 create_table 创建新表，list_tables 获取所有表格列表，describe-table 查看特定表格的架构信息。
商业洞察记录：借助 append_insight 向备忘录资源添加新的商业洞察。

📦 安装指南

运行环境

Python 3.x
依赖包
- pyodbc>=4.0.39
- pydantic>=2.0.0
- mcp>=0.1.0
ODBC 驱动器 17 for SQL Server

安装依赖包

CD /d ~/mssql-mcp  
pip install -r requirements.txt

配置

# 在与 server.py 同一文件夹中创建 config.json，添加内容：
{
    "database": {
        "driver": "ODBC Driver 17 for SQL Server",
        "server": "服务器 IP",
        "database": "数据库名称",
        "username": "用户名",
        "password": "密码",
        "trusted_connection": false
    },
    "server": {
        "name": "mssql-manager",
        "version": "0.1.0"
    }
}

Claude Desktop、Windsurf

# 将以下内容添加到 claude_desktop_config.json 中。注意：请使用您的路径  
{
    "mcpServers": {
        "mssql": {
            "command": "python",
            "args": [
                # 您的路径，例如："C:\\mssql-mcp\\src\\server.py"
                "~/server.py"
            ]
        }
    }
}

Cursor

# 注意：请使用您的路径  
npx -y @modelcontextprotocol/inspector python C:\\mssql-mcp\\src\\server.py

💻 使用示例

演示

数据库表如下所示。列名未标准化，AI 会自行匹配。SQL 执行过程中出现的错误将自动修正。

Table

以下是演示：

Demo

📚 详细文档

项目结构

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

📄 许可证

本项目采用 MIT License 进行许可。

mssql-mcp