MSSQL MCP Server

MSSQL MCP 服务

一个用于只读访问 Microsoft SQL Server 的模型上下文协议（MCP）服务。此服务通过 MCP 协议为 MSSQL 数据库提供安全的只读访问。

功能

• 只读操作：仅允许 SELECT、DECLARE 和 SET（用于局部变量）查询
• 架构探索：浏览数据库、表、列和索引
• 安全查询：防范 SQL 注入并验证查询
• 连接管理：安全处理连接并妥善清理

安装

1. 克隆此仓库：

git clone <repository-url>
cd mssql-mcp

2. 安装依赖：

pip install -e .

3. 设置环境变量：

cp .env.example .env
# Edit .env with your database connection details

**重要提示：**服务会自动从当前目录下的 .env 文件加载环境变量。请确保创建此文件并填写数据库连接详情。

配置

创建一个 .env 文件并填写 MSSQL 连接详情：

MSSQL_SERVER=localhost
MSSQL_DATABASE=your_database
MSSQL_USERNAME=your_username
MSSQL_PASSWORD=your_password
MSSQL_PORT=1433
MSSQL_TIMEOUT=30
MSSQL_CHARSET=UTF-8
MSSQL_AUTOCOMMIT=true

使用

开发模式

mcp dev src/mssql_mcp/server.py

Claude Desktop 集成

mcp install src/mssql_mcp/server.py --name "MSSQL Server"

直接执行

python -m mssql_mcp.server

可用资源

• db://schemas - 列出当前数据库中的所有架构
• db://tables/{database} - 列出当前数据库中的所有表
• db://schema_tables/{schema_name} - 列出指定架构中的表
• db://columns/{schema_name}/{table_name} - 获取表的列信息
• db://indexes/{database}/{schema_name}/{table_name} - 获取表的索引信息

可用工具

• list_databases - 列出所有可访问的数据库
• list_tables - 列出当前数据库中的表

安全性

此服务实施了多项安全措施：

• 仅允许 SELECT、DECLARE 和 SET（用于局部变量）语句
• SQL 解析与验证
• 尽可能使用参数化查询
• 保护连接字符串安全
• 禁止 DDL 或 DML 操作

要求

• Python 3.9+
• 可访问 Microsoft SQL Server 实例
• pymssql 库（随依赖项自动安装）

许可证

MIT 许可证