SQL Server数据操作工具

MSSQL MCP Writer是一个用于Microsoft SQL Server的数据操作工具,提供数据插入、更新和删除功能,适合数据工程师和ETL工作流程。

  • by ConnorBritain
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ConnorBritain/mssql-mcp-writer

使用说明

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 执行前显示受影响的行

文档

完整的文档、配置示例和治理详细信息可在主存储库中获得:

MSSQL MCP服务器文档


许可证

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作者