MCP MSSQL Server

MCP MSSQL Server

一个使用 NestJS 构建、用于集成 Microsoft SQL Server 的 MCP（Model Context Protocol）服务。此服务支持 Claude Code 和其他 MCP 客户端通过标准化工具与 SQL Server 数据库交互。

功能特性

• MCP 协议支持：完整实现 Model Context Protocol，支持 SQL Server 操作
• Windows 身份验证：支持 Windows（NTLM）和 SQL Server 身份验证
• 全面的 SQL 工具：执行查询、探索架构、管理表和运行存储过程
• 健康监控：内置数据库连接健康检查
• 连接池：高效管理数据库连接

MCP 工具

此服务通过 MCP 工具提供以下 SQL 操作：

• execute-query：执行支持参数的 SQL 查询
• get-schema：获取数据库架构信息
• list-tables：列出数据库中的所有表
• describe-table：获取包含约束的详细表结构
• get-table-data：获取支持筛选的分页表数据
• execute-procedure：执行带参数的存储过程

安装

npm install

配置

创建 .env 文件并填写数据库配置：

# SQL Server Connection
MSSQL_HOST=localhost
MSSQL_PORT=1433
MSSQL_DATABASE=your_database

# Authentication Mode (choose one)
# For SQL Server Authentication:
MSSQL_USERNAME=your_username
MSSQL_PASSWORD=your_password

# For Windows Authentication:
MSSQL_WIN_AUTH=true
MSSQL_DOMAIN=your_domain
MSSQL_USERNAME=domain\username
MSSQL_PASSWORD=your_password

# Connection Options
MSSQL_ENCRYPT=true
MSSQL_TRUST_CERT=true

# Server Port
PORT=3000

开发

# Start in development mode
npm run start:dev

# Start with debugging
npm run start:debug

# Build the application
npm run build

# Start production build
npm run start:prod

测试

# Unit tests
npm run test

# Watch mode
npm run test:watch

# End-to-end tests
npm run test:e2e

# Test coverage
npm run test:cov

代码质量

# Run ESLint with auto-fix
npm run lint

# Format code with Prettier
npm run format

MCP 端点

服务运行时（默认端口为 3000）：

• MCP 协议：http://localhost:3000/mssql/mcp
• SSE（Claude Code）：http://localhost:3000/mssql/sse
• 健康检查：http://localhost:3000/mssql/health

在 Claude Code 中使用

1. 启动 MCP 服务：npm run start:dev
2. 将 Claude Code 配置为连接到：http://localhost:3000/mssql/mcp
3. 通过 Claude Code 的 MCP 界面使用提供的 SQL 工具

架构

• MCPModule：处理 /mssql 命名空间下的 MCP 协议实现
• DatabaseModule：管理 SQL Server 连接和身份验证
• HealthModule：提供数据库健康监控
• 无 REST 端点：所有功能仅通过 MCP 工具提供

许可证

ISC