🚀 微软SQL Server MCP服务器
微软SQL Server MCP服务器是一个模型上下文协议（MCP）服务器，可用于安全地与微软SQL Server数据库进行交互。它允许AI助手列出表格、读取数据并执行带有适当错误处理的SQL查询，通过受控接口进行数据库探索和分析，使整个过程更加安全且结构化。
🚀 快速开始
本服务器可让AI助手安全地与微软SQL Server数据库交互，实现表格列出、数据读取及SQL查询执行等功能。
✨ 主要特性
- 🔖 列出可用的SQL Server表作为资源。
- 📖 读取表内容。
- 🛠️ 执行SQL查询并进行适当错误处理。
- 🔐 通过环境变量实现数据库的安全访问。
- 📝 全面日志记录。
- ⚙️ 自动系统依赖安装。
📦 安装指南
通过MCP安装时会自动安装所需的系统依赖（如FreeTDS）：
pip install mssql-mcp-server
📚 详细文档
配置
设置以下环境变量：
MSSQL_SERVER=localhost
MSSQL_USER=your_username
MSSQL_PASSWORD=your_password
MSSQL_DATABASE=your_database
使用方法
与Claude桌面配合使用
将以下内容添加到claude_desktop_config.json中：
{
"mcpServers": {
"mssql": {
"command": "uv",
"args": [
"--directory",
"path/to/mssql_mcp_server",
"run",
"mssql_mcp_server"
],
"env": {
"MSSQL_SERVER": "localhost",
"MSSQL_USER": "your_username",
"MSSQL_PASSWORD": "your_password",
"MSSQL_DATABASE": "your_database"
}
}
}
}
作为独立服务器运行
# 安装依赖项
pip install -r requirements.txt
# 启动服务器
python -m mssql_mcp_server
开发
# 克隆仓库
git clone https://github.com/RichardHan/mssql_mcp_server.git
cd mssql_mcp_server
# 创建虚拟环境
python -m venv venv
source venv/bin/activate # 或 `venv\Scripts\activate` 在Windows上
# 安装开发依赖项
pip install -r requirements-dev.txt
# 运行测试
pytest
安全注意事项
⚠️ 重要提示
- 永远不要提交环境变量或凭证。
- 使用权限最小的数据库用户。
- 考虑在生产环境中实现查询白名单。
- 监控和记录所有数据库操作。
安全最佳实践
此MCP服务器需要数据库访问权限才能运行。出于安全考虑：
- 创建一个专用的SQL Server登录，具有最小的权限。
- 不要使用sa凭证或管理帐户。
- 限制数据库访问为仅必需的操作。
- 启用日志记录用于审核目的。
- 定期进行安全审查数据库访问。
请参阅SQL Server安全配置指南获取详细说明，包括如何：
- 创建受限的SQL Server登录。
- 设置适当的权限。
- 监控数据库访问。
- 安全最佳实践。
⚠️ 重要提示
始终遵循最小特权原则来配置数据库访问。
📄 许可证
本项目采用MIT许可证 - 请参阅LICENSE文件以获取详细信息。
💪 贡献
- 叉克仓库。
- 创建功能分支（
git checkout -b feature/amazing-feature）。 - 提交更改（
git commit -m 'Add some amazing feature'）。 - 推送到分支（
git push origin feature/amazing-feature）。 - 打开Pull Request。