MCP SQL Server

MCP SQL Server

一个 Model Context Protocol（MCP）服务，可让 Claude 等 AI 助手通过本地连接安全地与 SQL Server 数据库交互。该服务通过受控接口提供数据库探索、查询执行和数据分析工具。

功能

• 🔒 安全的本地数据库访问：使用 SQL Authentication 连接到 SQL Server
• 🔍 架构探索：发现表、列和关系
• 📊 查询执行：运行 SQL 查询并妥善处理错误
• 🛡️ 安全控制：内置防护措施，防止执行有害操作

先决条件

• Node.js 18.0 或更高版本
• npm（Node 包管理器）
• SQL Server
• Claude Desktop 桌面应用

安装

1. 克隆仓库

git clone https://github.com/MKhan997733/mcp-server-sql.git
cd mcp-server-sql

2. 安装依赖项

npm install

3. 配置环境变量

在项目根目录中创建 .env 文件：

DB_SERVER=
DB_NAME=
DB_USER=
DB_PASSWORD=
DB_PORT=

Claude Desktop 配置

1. 找到 Claude Desktop 配置文件

配置文件位于：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

2. 添加 MCP 服务配置

编辑 claude_desktop_config.json 文件并添加 MCP 服务：

对于 SQL Authentication：

{
  "mcpServers": {
    "sql-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-server-sql/index.js"
      ],
      "env": {
        "DB_SERVER": "localhost",
        "DB_NAME": "your_database",
        "DB_USER": "your_username",
        "DB_PASSWORD": "your_password",
        "DB_PORT": "port"
      }
    }
  }
}

重要：将 /absolute/path/to/mcp-server-sql/ 替换为克隆仓库的实际路径。

3. 重启 Claude Desktop

保存配置文件后，重启 Claude Desktop，使更改生效。

用法

完成配置后，你可以通过 Claude 与 SQL Server 数据库交互，例如询问：

• “我的数据库中有哪些表？”
• “显示 Users 表的架构”
• “查询 Orders 表，并显示上周的订单”
• “找出总购买金额最高的 10 位客户”
• “显示数据库中的所有存储过程”

交互示例

发现表：

You: Can you show me what tables exist in my database?
Claude: I'll help you discover the tables in your SQL Server database...

查询数据：

You: Show me all customers who made purchases over $1000 in the last month
Claude: I'll query your database to find customers with purchases over $1000...

探索架构：

You: What columns does the Products table have?
Claude: Let me examine the structure of the Products table...

可用工具

MCP 服务向 Claude 提供以下工具：

1. discover_tables：列出 SQL Server 数据库中的所有表
2. table_details：获取特定表的详细架构信息
3. execute_query：运行 SELECT 查询（默认只读）
4. get_stored_procedures：列出所有存储过程
5. get_table_indexes：查看表上的索引
6. get_table_constraints：查看约束（PK、FK 等）

安全最佳实践

1. 使用专用 SQL Server 登录名：为 MCP 服务创建具有最低必要权限的专用登录名
2. 只读访问：为数据库用户配置只读访问权限
3. 仅限本地连接：服务仅接受连接到 localhost 的请求
4. 审计日志记录：启用 SQL Server 审计日志记录，以跟踪所有查询

运行服务

# Run directly

npm build

node <absolute-path>/build/index.js

（由 AI 生成，经 MKHAN997733 审核）