
MSSQL数据库MCP服务器(本地SQL Server版)
🚀 此版本已修改为与LOCAL SQL SERVER 2019一起使用,而不是Azure SQL。\ 无浏览器登录。没有Azure AD。没有“PC用户名”回退。只是纯粹的SQL Server身份验证。
______________________________________________________________________
这是什么? 🤔
这是一个服务器,可以让你的LLM(如Claude)直接与你的 本地Microsoft SQL Server数据库!把它想象成一个友好的翻译器,位于你的人工智能助手和数据库之间,确保他们可以安全有效地聊天-- 无需Azure或浏览器登录.
快速示例
You: "Show me all customers from Tehran"
Claude: *queries your local SQL Server database and gives you the answer in plain English*______________________________________________________________________
它是如何工作的? 🛠️
该服务器利用了模型上下文协议(MCP),这是一个通用的框架,可以作为人工智能模型和数据库之间的通用翻译器。它支持多种AI助手,包括 克劳德桌面 和 VS代码代理.
⚠️ 重要:此叉子已修改为使用 使用用户名和密码 (用户名/密码) 本地SQL Server 2019+ --不是Azure AD。
🔒 凭据硬编码在 src/index.ts --无需配置环境变量。\ ❓ *为什么要硬编码?* → See WHY_HARD_CODED.md
______________________________________________________________________
它能做什么? 📊
- 只需用简单的英语提问即可运行SQL查询
- 创建、读取、更新和删除数据
- 管理数据库架构(表、索引)
- 安全连接处理(带
TRUST_SERVER_CERTIFICATE=true对于本地开发人员) - 实时数据交互
______________________________________________________________________
快速开始🚀
先决条件
- Node.js 14或更高版本
- Claude Desktop或带有代理扩展名的VS Code
- 本地SQL Server 2019+实例正在运行
- 数据库(例如。,
Test)以及SQL登录(例如。,ai/1234)
______________________________________________________________________
建立项目
- 再进行\
在根文件夹中运行以下命令以安装所有必要的依赖项:
npm install- 构建项目\
通过运行以下命令编译项目:
npm run build______________________________________________________________________
配置设置
⚙️ 凭据是硬编码的——不需要配置!
与原始版本不同, 您不需要设置环境变量.
所有连接详细信息都硬编码在:
src/index.ts示例(已在代码中设置):
server: "DESKTOP-3445U4I\\SQL2019",
database: "Test",
user: "ai",
password: "1234",
options: {
encrypt: false,
trustServerCertificate: true
}👉 只需在中更新这些值 src/index.ts 如有需要→ 重建→ done.
______________________________________________________________________
选项1:VS代码代理设置
- 安装VS代码代理扩展
- 打开VS代码 - 转到扩展(Ctrl+Shift+X) - 搜索“Agent”并安装官方Agent扩展
- 创建MCP配置文件
- 创建一个 .vscode/mcp.json 工作区中的文件 - 添加以下配置:
{
"servers": {
"mssql-nodejs": {
"type": "stdio",
"command": "node",
"args": ["L:\\AiAccess\\Project\\dev\\SQL-AI-samples\\MssqlMcp\\Node\\dist\\index.js"]
}
}
}- 重新启动VS代码
- 关闭并重新打开VS Code以使更改生效
- 验证MCP服务器
- 打开命令面板(Ctrl+Shift+P) - 运行“MCP:列出服务器”以验证您的服务器是否已配置 - 您应该在可用服务器列表中看到“mssql-nodejs”
______________________________________________________________________
选项2:Claude桌面设置
- 打开克劳德桌面设置
- 导航到文件→ 设置→ 开发者→ 编辑配置 - 打开 claude_desktop_config 文件
- 添加MCP服务器配置
将内容替换为:
{
"mcpServers": {
"MSSQL MCP": {
"type": "stdio",
"command": "node",
"args": ["L:\\AiAccess\\Project\\dev\\SQL-AI-samples\\MssqlMcp\\Node\\dist\\index.js"]
}
}
}- 重新启动克劳德桌面
- 关闭并重新打开Claude Desktop以使更改生效
______________________________________________________________________
使用示例
配置后,您可以使用自然语言与数据库交互:
- “列出测试数据库中的所有表”
- “显示按名称订购的前5位客户”
- “描述订单表的结构”
- “将产品价格更新为99.99,其中product_id=100”
______________________________________________________________________
安全说明
- 服务器需要一个WHERE子句用于读取操作,以防止意外的全表扫描
- 更新操作需要显式的WHERE子句以确保安全性
- 集
READONLY: "true"在……里面src/index.ts如果你只需要读取权限
______________________________________________________________________
❓ 为什么是硬编码?为什么没有Azure?
此版本完全删除了Azure AD身份验证,并使用本地SQL Server Auth以实现简单性和可靠性。
如果你想了解我们为什么硬编码配置以及“ENIAC”是什么意思,请阅读:\ 👉 WHY_HARD_CODED.md
______________________________________________________________________
现在,您应该已经成功配置了MCP服务器 本地SQL Server 使用您首选的AI助手。这种设置允许您通过自然语言查询与数据库无缝交互——没有云,没有浏览器,没有麻烦。
______________________________________________________________________
🙏 鸣谢
这个项目是对原始项目的修改 mssql_mcp_server 靠近 韩.
我已将其调整为与之配合使用 使用SQL Server身份验证的本地SQL Server 2019 --删除Azure AD依赖关系,修复MCP协议合规性,并硬编码凭据以提高可靠性。
原始回购:\ 👉
理查德,谢谢你为这个项目奠定了基础。
🎉 享受您的本地AI驱动的SQL查询!
---