🔌 MCP SQL Server连接器--克劳德桌面集成
用于集成的技术文档 克劳德桌面版 与实例 Microsoft SQL Server 通过 模型上下文协议(MCP). 🗓️ *上次更新:2025年12月* --SQL Server测试版:Microsoft SQL Server 2025(RTM)企业开发版
______________________________________________________________________
摘要
______________________________________________________________________
✨ 功能
| 类别 | 描述 |
|---|---|
| 数据库操作语言 | SELECTJOINs复合物, INSERT, UPDATE, DELETE e MERGE 支持交易。 |
| 数据定义语言 创建、更改和删除表、视图、索引、存储过程和触发器 | |
| 元数据 | 咨询 INFORMATION_SCHEMA通过统计和计划分析 SET STATISTICS |
安全 通过角色验证权限: db_owner, db_ddladmin, db_datareader, db_datawriter |
______________________________________________________________________
🏗️ 建筑
集成使用MCP协议,允许Claude通过本地Node.js服务器实时执行SQL命令。
Claude Desktop ──(MCP)──▶ Node.js Server ──(TCP 1433)──▶ SQL Server| 组件 | 细节 |
|---|---|
| 协议 | 模型上下文协议(MCP) |
| 运行时 | Node.js v18或更高级 |
| 连接 | TCP/IP通过端口1433 |
| 操作 系统 | Windows 10+e macOS 11+ |
______________________________________________________________________
🛠️ 安装
先决条件
- 安装 Node.js v18 或更高版本
- 活动且可访问的 SQL Server 实例(本地、Docker 或远程)
- 波尔塔
1433在系统防火墙中释放
程序
通过 npm 全局安装服务器包 :
npm install -g @modelcontextprotocol/server-mssql______________________________________________________________________
⚙️ 配置
编辑文件 claude_desktop_config.json 在您系统的相应目录中:
| 系统 | 路径 |
|---|---|
| 视窗 | %APPDATA%\Claude\claude_desktop_config.json |
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
文件结构
{
"mcpServers": {
"mcp-sql-server": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sqlserver"],
"env": {
"SQL_CONNECTION_STRING": "SUA_STRING_DE_CONEXAO",
"TZ": "America/Sao_Paulo"
}
}
}
}⚠️ 注意 : 替换 SUA_STRING_DE_CONEXAO 在保存文件之前,使用 SQL Server 实例的实际连接字符串。______________________________________________________________________
⚠️ 限制
| 限制 | 细节 |
|---|---|
文件系统 不支持 A BACKUP DATABASE, RESTORE 或 BULK INSERT (需要物理磁盘访问) | |
| 超时 | 限制 15秒 按要求 |
| 管理 | sp_configure 不支持通过 SQL Server Agent 进行作业管理。 |
______________________________________________________________________
🤝 贡献
欢迎捐款!建议改进或报告技术不一致:
______________________________________________________________________
📄 许可证
此项目遵循 MCP 连接器的标准许可条款。有关使用和分发的详细信息,请参阅官方存储库中的许可证。
______________________________________________________________________
📞 联系
亚历山大\ 📧 alemiti@gmail.com
