yuppie-mcp-mssql

Microsoft SQL Server MCP Server — 让 AI 助手能够查询和操作 SQL Server，无需安装任何本地驱动（纯 Python 实现）。

特性

• 无驱动：基于 python-tds，无需 ODBC 驱动或 FreeTDS
• 权限控制：INSERT / UPDATE / DELETE / DDL 各自独立开关，默认全只读
• 支持 stdio 和 Streamable HTTP 两种传输模式

快速开始

Claude Code

在 .mcp.json 中添加（--refresh 强制拉取 PyPI 最新版，忽略本地缓存）：

{
  "mcpServers": {
    "mssql": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--refresh", "yuppie-mcp-mssql"],
      "env": {
        "DB_HOST": "localhost",
        "DB_PORT": "1433",
        "DB_NAME": "master",
        "DB_USER": "sa",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

Cursor

在 ~/.cursor/mcp.json 中添加：

{
  "mcpServers": {
    "mssql": {
      "command": "uvx",
      "args": ["yuppie-mcp-mssql"],
      "env": {
        "DB_HOST": "localhost",
        "DB_USER": "sa",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

Cherry Studio

打开 设置 → MCP Servers，粘贴以下 JSON 配置：

{
  "mcpServers": {
    "mssql": {
      "command": "uvx",
      "args": ["yuppie-mcp-mssql"],
      "env": {
        "DB_HOST": "your_host",
        "DB_PORT": "1433",
        "DB_NAME": "your_database",
        "DB_USER": "your_username",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

OpenCode

在 ~/.opencode/opencode.json 中添加：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mssql": {
      "type": "local",
      "command": ["uvx", "yuppie-mcp-mssql"],
      "enabled": true,
      "environment": {
        "DB_HOST": "localhost",
        "DB_USER": "sa",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

Claude Desktop

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "mssql": {
      "command": "uvx",
      "args": ["yuppie-mcp-mssql"],
      "env": {
        "DB_HOST": "localhost",
        "DB_USER": "sa",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

环境变量

连接配置

变量	说明	必填	默认值
DB_HOST	SQL Server 主机地址	是	localhost
DB_PORT	SQL Server 端口	否	1433
DB_NAME	默认数据库	否	master
DB_USER	用户名	是	-
DB_PASSWORD	密码	是	-

权限控制

变量	说明	默认值
DB_ALLOW_INSERT	是否允许 INSERT	false
DB_ALLOW_UPDATE	是否允许 UPDATE	false
DB_ALLOW_DELETE	是否允许 DELETE	false
DB_ALLOW_DDL	是否允许 DDL（CREATE/DROP/ALTER/TRUNCATE）	false

传输模式

变量	说明	默认值
MCP_TRANSPORT	传输模式：stdio 或 streamable_http	stdio
MCP_PORT	HTTP 模式端口	8000

测试与调试

使用 MCP Inspector

在项目根目录创建 .env 文件配置数据库连接：

DB_HOST=your_host
DB_PORT=1433
DB_NAME=your_database
DB_USER=your_username
DB_PASSWORD=your_password

然后启动 MCP Inspector（会自动读取 .env 文件）：

npx @modelcontextprotocol/inspector uv run yuppie-mcp-mssql

Inspector 会打开一个网页界面，可以：

• 查看所有可用工具
• 直接调用工具测试
• 查看请求/响应日志
• 测试环境变量

运行测试

# 安装开发依赖
uv pip install -e ".[dev]"

# 运行测试
uv run pytest -v

可用工具

工具	说明
mssql_get_db_info	获取当前数据库基本信息（版本、服务器名、当前用户等）
mssql_execute_sql	执行 SQL 语句（SELECT 始终允许，写操作受环境变量控制）
mssql_list_tables	列出当前数据库下的所有表
mssql_describe_table	获取表的列结构（列名、类型、可空性等）
mssql_export_to_csv	将查询结果导出到 CSV 文件（支持自定义分隔符）

提示示例

基础查询

查一下当前连接的是哪个数据库，SQL Server 版本是多少

列出当前数据库里所有的表

描述一下 dbo.Orders 表的结构

查询 dbo.Orders 表中最近 10 条记录

统计 dbo.Orders 表中每个状态的订单数量，按数量降序排列

导出功能

将查询结果导出到 CSV 文件（逗号分隔，自动创建目录）

导出查询结果为 TSV 格式（制表符分隔，适合 Excel 打开）

导出数据到自定义路径，使用分号分隔

License

MIT