使用说明
MSSQL MCP编写器
用于Microsoft SQL server的模型上下文协议服务器,具有读取和数据操作。
具有预览/确认保护的完整数据操作功能(INSERT、UPDATE、DELETE),但没有DDL操作。非常适合需要修改数据但希望防止模式更改的数据工程师和ETL工作流。
建筑
这个包裹很薄 @connorbritain/mssql-mcp-core,其中包含所有共享逻辑、工具和治理功能。包装器选择 "writer" 层次和委托给核心 startMcpServer() 功能。这种设计能够:
- 硬分离 在包级别,受监管的企业可以保证某些构建在物理上不能执行破坏性操作
- 独立版本控制 --每一层都可以单独发布,并有自己的发布周期
- 清晰的审计跟踪 —
"we only allow mssql-mcp-writer in staging"是编译时保证
核心库处理所有SQL Server连接、工具调度、审计日志记录和治理实施。
包装层
| 包 | npm | 工具 | 用例 |
|---|---|---|---|
| mssql-mcp阅读器 | @connorbritain/mssql-mcp-reader |
14只读 | 分析师、审计师、安全探索 |
| mssql mcp编写器 (这个) | @connorbritain/mssql-mcp-writer |
17(阅读器+数据操作) | 数据工程师、ETL开发人员 |
| mssql-mcp服务器 | @connorbritain/mssql-mcp-server |
20(所有工具) | DBA,完全管理员权限 |
配置生成器 --可视化向导生成您的 mcp_config.json 和 environments.json 文件夹。
包含的工具
| 类别 | 工具 |
|---|---|
| 发现 | search_schema, describe_table, list_table, list_databases, list_environments |
| 分析 | profile_table, inspect_relationships, inspect_dependencies, explain_query |
| 数据读取 | read_data (仅限选择) |
| 数据写入 | insert_data, update_data, delete_data (带预览/确认) |
| 脚本 | list_scripts, run_script |
| 运营 | test_connection, validate_environment_config |
不包括: create_table, create_index, drop_table (DDL操作)
快速开始
安装
npm install -g @connorbritain/mssql-mcp-writer@latest
MCP客户端配置
{
"mcpServers": {
"mssql": {
"command": "npx",
"args": ["@connorbritain/mssql-mcp-writer@latest"],
"env": {
"SERVER_NAME": "127.0.0.1",
"DATABASE_NAME": "mydb",
"SQL_AUTH_MODE": "sql",
"SQL_USERNAME": "app_user",
"SQL_PASSWORD": "YourPassword123"
}
}
}
}
配置
| 变量 | 必填 | 备注 |
|---|---|---|
SERVER_NAME |
是 | SQL Server主机名/IP |
DATABASE_NAME |
是 | 目标数据库 |
SQL_AUTH_MODE |
sql, windows,或 aad (默认值: aad) |
|
SQL_USERNAME / SQL_PASSWORD |
需要 sql/windows 模式 |
|
READONLY |
true 禁用写入工具 |
|
ENVIRONMENTS_CONFIG_PATH |
多环境JSON配置路径 | |
SCRIPTS_PATH |
命名SQL脚本目录的路径 | |
AUDIT_LOG_PATH |
自定义审核日志路径 |
特性
MSSQL MCP系列中的所有软件包共享:
- 多环境支持 -具有每个环境策略的命名数据库环境(prod、staging、dev)
- 治理控制 -
allowedTools,deniedTools,allowedSchemas,deniedSchemas,requireApproval - 审核日志记录 -带有会话ID和自动编校的JSON行日志
- 秘密管理 -
${secret:NAME}用于安全凭证处理的占位符 - 命名SQL脚本 -具有治理控制的预先批准的参数化查询
- 预览/确认突变 -
update_data和delete_data执行前显示受影响的行
文档
完整的文档、配置示例和治理详细信息可在主存储库中获得:
许可证
MIT许可证。看 许可证 了解详情。
存储库: https://github.com/ConnorBritain/mssql-mcp-writer 问题: https://github.com/ConnorBritain/mssql-mcp-writer/issues npm: https://www.npmjs.com/package/@connorbritain/mssql-mcp作者