MCP Server SQL

MCP SQL Server

一个模型上下文协议（MCP）服务器，使像Claude这样的人工智能助手能够通过本地连接安全地与SQL server数据库交互。此服务器通过受控界面提供数据库探索、查询执行和数据分析工具。

特性

• 🔒 安全本地数据库访问：使用SQL身份验证连接到SQL Server
• 🔍 模式探索：发现表、列和关系
• 📊 查询执行：运行具有适当错误处理的SQL查询
• 🛡️ 安全控制：内置防止有害操作的保护措施

先决条件

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

安装

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桌面配置

1.找到Claude桌面配置文件

配置文件位于：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2.添加MCP服务器配置

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

对于SQL身份验证：

{
  "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与SQL Server数据库交互，询问以下问题：

• “我的数据库中有哪些表？”
• “显示Users表的架构”
• “查询订单表并显示上周的订单”
• “按总购买金额查找前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_conconstraints：视图约束（PK、FK等）

安全最佳实践

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

运行服务器

# Run directly

npm build

node /build/index.js

（人工智能生成，由MKHAN997733审核）