SQL Server连接器

通过Model Context Protocol (MCP)实现Claude Desktop与Microsoft SQL Server的集成,支持SQL命令执行、数据库管理和元数据查询。

  • by alemiti7
  • 本地部署
  • 更新于
在 GitHub 查看 alemiti7/MCP-SQL-Server-Integre-o-Claude-Desktop-ao-seu-Banco-de-Dados

使用说明

🔌 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