MSSQL MCP服务器
一种模型上下文协议（MCP）服务器，使AI助手能够通过自然语言与Microsoft SQL server数据库进行交互。
概述
这个MCP服务器允许像Claude这样的人工智能助手无缝连接和查询Microsoft SQL server数据库。用简单的英语提问，并从数据库中获得即时结果——不需要SQL知识！
快速示例
You: "Show me all customers from New York"
Claude: *queries your SQL Server database and returns the results in plain English*特性
模型上下文协议（MCP）是一种标准化协议，使AI助手能够与外部系统通信。此服务器实现MCP，以提供对SQL server数据库的安全、受控访问。
能力
- 自然语言查询：用简单的英语提问并获得SQL Server结果
- 完整的CRUD操作：通过对话命令创建、读取、更新和删除数据
- 模式管理：管理表、索引和数据库结构
- 安全认证：同时支持SQL身份验证和Azure Active Directory
- 只读模式：可选安全模式，防止意外数据修改
- 连接安全性：可配置的超时和SSL/TLS支持
快速开始
先决条件
- Node.js 16或更高版本（用v22.18.0测试）
- Microsoft SQL Server（本地实例、SQL Express或远程服务器）
- Claude Desktop、带代理扩展的VS Code或其他兼容MCP的AI助手
安装
- 克隆仓库
git clone https://github.com/yourusername/mssql-mcp-server.git
cd mssql-mcp-server- 再进行
npm install- 构建项目
npm run build配置设置
选项1:VS代码代理设置
- 安装VS代码代理扩展
- 打开VS代码 - 转到扩展（Ctrl+Shift+X或Cmd+Shift+X） - 搜索“Agent”并安装官方Agent扩展
- 创建MCP配置文件
创建 .vscode/mcp.json 工作区中的文件：
{
"servers": {
"mssql": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/mssql-mcp-server/dist/index.js"],
"env": {
"SERVER_NAME": "localhost",
"DATABASE_NAME": "your-database-name",
"READONLY": "false"
}
}
}
}- 备选方案：用户设置配置
您还可以在VS代码设置中全局配置此设置：
- 打开设置（Ctrl+或Cmd+） - 搜索“mcp” - 点击“在settings.json中编辑” - 添加配置：
{
"mcp": {
"servers": {
"mssql": {
"command": "node",
"args": ["/absolute/path/to/mssql-mcp-server/dist/index.js"],
"env": {
"SERVER_NAME": "localhost",
"DATABASE_NAME": "your-database-name",
"READONLY": "false"
}
}
}
}
}- 重新启动VS代码
- 关闭并重新打开VS Code以使更改生效
- 验证MCP服务器
- 打开命令面板（Ctrl+Shift+P） - 运行“MCP:列出服务器”以验证您的服务器是否已配置 - 您应该在可用服务器列表中看到“mssql”
选项2:Claude桌面设置
- 查找Claude桌面配置
- 视窗: %APPDATA%\Claude\claude_desktop_config.json - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json
或者使用内置菜单：设置→ 开发者→ 编辑配置
- 添加MCP服务器配置
将服务器添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"mssql": {
"command": "node",
"args": ["/absolute/path/to/mssql-mcp-server/dist/index.js"],
"env": {
"SERVER_NAME": "localhost",
"DATABASE_NAME": "your-database-name",
"READONLY": "false"
}
}
}
}- 重新启动克劳德桌面
- 完全退出并重新打开Claude Desktop以加载新配置
配置参数
| 参数 | 必填 | 说明 | 默认值 |
|---|---|---|---|
SERVER_NAME | 是 | SQL Server主机名（例如。， localhost, .\SQLEXPRESS, 192.168.1.10，或Azure： my-server.database.windows.net) | - |
DATABASE_NAME | 是 | 目标数据库名称 | - |
READONLY | 否 | 设置为 "true" 启用只读模式 | "false" |
CONNECTION_TIMEOUT | 否 | 连接超时（秒） | 30 |
TRUST_SERVER_CERTIFICATE | 否 | 信任自签名证书（本地SQL Server通常需要） | "false" |
认证
服务器支持多种身份验证方法：
身份验证 （本地SQL Server的默认设置）：
- 使用您当前的Windows凭据
- 本地实例无需额外配置
- 最常见于SQL Express和本地开发
Azure Active Directory （适用于Azure SQL）：
- 需要
@azure/identity套餐（含） - 通过Azure CLI登录：
az login - 适用于Azure SQL数据库连接
使用用户名和密码:
- 用户名/密码验证
- 可能需要修改源代码才能安全地传递凭据
- 不建议-尽可能使用Windows Auth或Azure AD
使用示例
配置后，使用自然语言与数据库交互：
"Show me all users from New York"
"Create a new table called products with columns for id, name, and price"
"Update all pending orders to completed status"
"List all tables in the database"
"What's the total revenue for last month?"安全与最佳实践
- WHERE条款必填：读取操作需要WHERE子句来防止意外的全表扫描
- 更新保护：更新和删除操作需要显式的WHERE子句
- 只读模式：设置
READONLY: "true"在不需要修改访问权限的生产环境中 - Azure AD身份验证：默认情况下使用安全的Azure Active Directory身份验证
- 连接加密：支持加密连接的SSL/TLS
示例配置
示例配置文件可在 src/samples/:
claude_desktop_config.json-Claude桌面配置模板vscode_agent_config.json-VS代码代理配置模板
测试环境
此MCP服务器已通过以下方式进行了测试和验证：
SQL Server版本：
- SQL Server 2025
- SQL Server Express 13
- Windows Server 2012上的本地SQL Server实例
开发工具：
- JetBrains DataGraph
- SQL Server管理工作室2021
- 带有代理扩展名的VS代码
人工智能助理：
- 克劳德桌面版
- 克劳德码（VS码）
- Gemini CLI
运行时间：
- Node.js v22.18.0
- Python 3.13
操作系统：
- Windows 11企业预览版
- Windows Server 2012
高级配置
启用EXEC工具（小心使用）
默认情况下，出于安全考虑，存储过程的执行受到限制。要启用EXEC工具，请执行以下操作：
- 查看中的文件
ALLOW_EXECUTE/目录 - 仔细评估对环境的安全影响
- 将所需文件复制到
src/tools/仅当您信任正在执行的存储过程时
安全警告：只有当您完全理解并信任数据库中的存储过程时，才能启用EXEC工具。
贡献
欢迎投稿！请随时提交问题或拉取请求。
致谢
该项目建立在社区出色工作的基础上：
- MSSQLMCP_DBA by oflindall-其他DBA工具
- Azure SQL AI示例 -原始Azure示例
- 如何将AI助手连接到SQL -设置指南灵感
许可证
MIT许可证-有关详细信息，请参阅许可证文件
支持
对于问题、疑问或贡献，请在GitHub上打开问题。