MSSQL MCP阅读器
](https://www.npmjs.com/package/@connorbritain/mssql-mcp-reader) 
用于Microsoft SQL server的只读模型上下文协议服务器。
安全的模式发现、分析和查询,数据修改风险为零。非常适合分析师、审计师和任何需要在没有写访问权限的情况下进行数据库探索的人。
建筑
这个包裹很薄 @connorbritain/mssql-mcp-core,其中包含所有共享逻辑、工具和治理功能。包装器选择 "reader" 层次和委托给核心 startMcpServer() 功能。这种设计能够:
- 硬分离 在包级别,受监管的企业可以保证某些构建在物理上不能执行破坏性操作
- 独立版本控制 --每一层都可以单独发布,并有自己的发布周期
- 清晰的审计跟踪 —
"we only allow mssql-mcp-reader in prod"是编译时保证
核心库处理所有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 (仅限选择) |
| 脚本 | list_scripts, run_script (只读脚本) |
| 运营 | test_connection, validate_environment_config |
不包括: insert_data, update_data, delete_data, create_table, create_index, drop_table
______________________________________________________________________
快速开始
安装
npm install -g @connorbritain/mssql-mcp-reader@latestMCP客户端配置
{
"mcpServers": {
"mssql": {
"command": "npx",
"args": ["@connorbritain/mssql-mcp-reader@latest"],
"env": {
"SERVER_NAME": "127.0.0.1",
"DATABASE_NAME": "mydb",
"SQL_AUTH_MODE": "sql",
"SQL_USERNAME": "readonly_user",
"SQL_PASSWORD": "YourPassword123"
}
}
}
}______________________________________________________________________
配置
| 变量 | 必填 | 备注 |
|---|---|---|
SERVER_NAME | 是 | SQL Server主机名/IP |
DATABASE_NAME | 是 | 目标数据库 |
SQL_AUTH_MODE | sql, windows,或 aad (默认值: aad) | |
SQL_USERNAME / SQL_PASSWORD | 需要 sql/windows 模式 | |
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脚本 -具有治理控制的预先批准的参数化查询
______________________________________________________________________
文档
完整的文档、配置示例和治理详细信息可在主存储库中获得:
______________________________________________________________________
许可证
MIT许可证。看 许可证 了解详情。
______________________________________________________________________
存储库: https://github.com/ConnorBritain/mssql-mcp-reader 问题: https://github.com/ConnorBritain/mssql-mcp-reader/issues npm: https://www.npmjs.com/package/@connorbritain/mssql-mcp阅读器
