SQL-Server-MCP

SQL Server MCP（Model Context Protocol）服务

一个轻量级 MCP stdio 服务，使用提供的凭据连接到 Microsoft SQL Server，并提供用于查询和发现架构的工具。

功能

• connect：通过 server、port、user、password 连接，可选参数为 database、encrypt。
• disconnect：关闭连接池。
• info：返回 @@VERSION。
• query：执行任意 SQL 并返回记录集。
• list_databases：列出数据库。
• list_schemas：列出架构。
• list_tables：列出表，可选使用 schema 筛选。

快速开始

• Node.js >= 18
• 安装依赖并构建：

  npm install
  npm run build
  

• 作为 MCP stdio 服务运行（供兼容 MCP 的客户端使用）：

  npm start
  

服务通过 stdio 启动，并等待 MCP 客户端（例如 Claude Desktop 或其他支持 MCP 的工具）驱动。按以下顺序使用工具：

1. 使用 SQL Server 凭据调用 connect
2. 调用 info、list_* 或 query

MCP 工具和架构

• connect 参数：

  {
    "server": "host or host\\\u005Cinstance",
    "port": 1433,
    "user": "sa",
    "password": "<secret>",
    "database": "master",
    "encrypt": true
  }
  

• query 参数：

  { "sql": "SELECT TOP 1 * FROM sys.databases" }
  { "sql": "SELECT * FROM INFORMATION_SCHEMA.TABLES" }
  

• 其他工具不需要参数，或可选使用 schema。

安全

• 凭据在调用时提供，不会被存储。建议使用安全的 MCP 客户端和环境。TLS encrypt 默认为 true。

开发

• 脚本：
  • 使用 npm run dev 通过 ts-node 运行
  • 使用 npm run build 将 JS 输出到 dist/
  • 使用 npm start 运行构建后的服务（dist/server.js）

提交

• chore：使用 TypeScript、tsconfig 和依赖初始化项目脚手架
• feat：实现包含 SQL Server 工具（connect、query、info、list_*）的 MCP stdio 服务
• docs：添加执行计划大纲和使用说明

许可证

MIT