{"_id":"@always-nobug/mcp-sqlserver","name":"@always-nobug/mcp-sqlserver","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@always-nobug/mcp-sqlserver","version":"1.0.0","description":"MCP Server for SQL Server database access","type":"module","main":"src/index.js","bin":{"mcp-sqlserver":"src/index.js"},"scripts":{"start":"node src/index.js","dev":"node --watch src/index.js"},"keywords":["mcp","sqlserver","database","model-context-protocol"],"author":{"name":"always-nobug"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","mssql":"^11.0.1"},"engines":{"node":">=18"},"gitHead":"90c9d453f9ca469d8c2df9e54fbe6bc6190d74f5","_id":"@always-nobug/mcp-sqlserver@1.0.0","_nodeVersion":"22.14.0","_npmVersion":"11.7.0","dist":{"integrity":"sha512-ScP7+deafO7DMpHF+gUScqDwlOjaaXPX70IQizrXdrTqtQ4hdLF3FM25D5nF2VXf1bKj14OGuzePFkEKIUSo1Q==","shasum":"ab0b0eca7a86fb90912fddb6e8770f3745d76a7e","tarball":"https://registry.npmjs.org/@always-nobug/mcp-sqlserver/-/mcp-sqlserver-1.0.0.tgz","fileCount":3,"unpackedSize":48200,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCzONhfjKkb1E8dXOH1nsPu+7Dh2deJjYhXy3/ee1XC8AIgSAVG6QmmOJHxJE1XT67Zu+tYeucYhabwiNPFQ+TjhYE="}]},"_npmUser":{"name":"gy-nobug","email":"1115284051@qq.com"},"directories":{},"maintainers":[{"name":"gy-nobug","email":"1115284051@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-sqlserver_1.0.0_1770551443971_0.3551787591757378"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-08T11:50:43.865Z","1.0.0":"2026-02-08T11:50:44.123Z","modified":"2026-02-08T11:50:44.391Z"},"maintainers":[{"name":"gy-nobug","email":"1115284051@qq.com"}],"description":"MCP Server for SQL Server database access","keywords":["mcp","sqlserver","database","model-context-protocol"],"author":{"name":"always-nobug"},"license":"MIT","readme":"# SQL Server MCP Server\r\n\r\n功能强大的 SQL Server 数据库 MCP (Model Context Protocol) 服务器，让 Claude 能够直接访问和操作 SQL Server 数据库。\r\n\r\n## 功能特性\r\n\r\n### 核心功能\r\n- **执行 SQL 查询** - 支持所有 SQL 语句 (SELECT, INSERT, UPDATE, DELETE, DDL 等)\r\n- **浏览数据库架构** - 自动获取表、视图、存储过程、函数的完整信息\r\n- **参数化查询** - 安全的参数绑定，防止 SQL 注入\r\n- **连接池管理** - 高效的数据库连接池\r\n\r\n### 可用工具\r\n\r\n| 工具名称 | 功能描述 |\r\n|---------|---------|\r\n| `sql_execute` | 执行任意 SQL 查询 |\r\n| `sql_list_tables` | 列出数据库中的所有表 |\r\n| `sql_describe_table` | 获取表的详细信息（列、类型、约束、索引） |\r\n| `sql_list_views` | 列出所有视图 |\r\n| `sql_describe_view` | 获取视图定义和详情 |\r\n| `sql_list_stored_procedures` | 列出所有存储过程 |\r\n| `sql_describe_stored_procedure` | 获取存储过程详情和参数 |\r\n| `sql_execute_stored_procedure` | 执行存储过程 |\r\n| `sql_list_databases` | 列出服务器上的所有数据库 |\r\n| `sql_get_schema_info` | 获取完整的数据库架构概览 |\r\n| `sql_list_indexes` | 列出表的所有索引 |\r\n| `sql_list_constraints` | 列出表的约束（主键、外键、唯一、检查） |\r\n| `sql_list_functions` | 列出所有用户定义函数 |\r\n| `sql_describe_function` | 获取函数详情 |\r\n\r\n## 安装步骤\r\n\r\n### 1. 安装依赖\r\n\r\n```bash\r\ncd mcp-sqlserver\r\nnpm install\r\n```\r\n\r\n### 2. 配置数据库连接\r\n\r\n通过环境变量配置数据库连接（无配置文件方式）：\r\n\r\n| 环境变量 | 说明 | 默认值 | 是否必需 |\r\n|---------|------|--------|---------|\r\n| MSSQL_HOST | 服务器地址 | localhost | 否 |\r\n| MSSQL_PORT | 服务器端口 | 1433 | 否 |\r\n| MSSQL_USER | 用户名 | sa | 否 |\r\n| MSSQL_PASSWORD | 密码 | - | **是** |\r\n| MSSQL_DATABASE | 数据库名 | NoBug | 否 |\r\n| MSSQL_SCHEMA | 默认架构 | dbo | 否 |\r\n| MSSQL_ENCRYPT | 是否加密连接 | false | 否 |\r\n| MSSQL_TRUST_CERT | 信任服务器证书 | true | 否 |\r\n| MSSQL_POOL_MAX | 连接池最大连接数 | 10 | 否 |\r\n| MSSQL_POOL_MIN | 连接池最小连接数 | 0 | 否 |\r\n| MSSQL_POOL_IDLE_TIMEOUT | 连接池空闲超时(毫秒) | 30000 | 否 |\r\n\r\n### 3. 配置 Claude Desktop\r\n\r\n在 Claude Desktop 的配置文件中添加此 MCP 服务器：\r\n\r\n**Windows 配置文件位置:**\r\n`%APPDATA%\\Claude\\claude_desktop_config.json`\r\n\r\n**添加以下配置:**\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"sqlserver\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"D:\\\\work\\\\NoBug\\\\mcp-sqlserver\\\\src\\\\index.js\"],\r\n      \"env\": {\r\n        \"MSSQL_HOST\": \"localhost\",\r\n        \"MSSQL_PORT\": \"1433\",\r\n        \"MSSQL_USER\": \"sa\",\r\n        \"MSSQL_PASSWORD\": \"YourPassword123\",\r\n        \"MSSQL_DATABASE\": \"NoBug\",\r\n        \"MSSQL_ENCRYPT\": \"false\",\r\n        \"MSSQL_TRUST_CERT\": \"true\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### 4. 重启 Claude Desktop\r\n\r\n重启 Claude Desktop 使配置生效。\r\n\r\n## 使用示例\r\n\r\n### 示例 1: 查看数据库架构\r\n\r\n在 Claude 中说:\r\n```\r\n请查看 NoBug 数据库的整体架构\r\n```\r\n\r\nClaude 会调用 `sql_get_schema_info` 工具，返回所有表、视图、存储过程和函数的概览。\r\n\r\n### 示例 2: 查看表结构\r\n\r\n```\r\n请查看 Users 表的结构\r\n```\r\n\r\nClaude 会调用 `sql_describe_table` 工具，返回:\r\n- 列信息（名称、类型、长度、是否可空）\r\n- 主键\r\n- 外键关系\r\n- 索引\r\n\r\n### 示例 3: 执行查询\r\n\r\n```\r\n请查询前 10 个用户\r\n```\r\n\r\nClaude 会生成并执行:\r\n```sql\r\nSELECT TOP 10 * FROM Users ORDER BY CreateTime DESC\r\n```\r\n\r\n### 示例 4: 创建新表\r\n\r\n```\r\n请创建一个产品分类表\r\n```\r\n\r\nClaude 会生成并执行建表 SQL 语句。\r\n\r\n## 环境变量\r\n\r\n| 变量名 | 说明 | 默认值 |\r\n|-------|------|--------|\r\n| MSSQL_HOST | 服务器地址 | localhost |\r\n| MSSQL_PORT | 服务器端口 | 1433 |\r\n| MSSQL_USER | 用户名 | sa |\r\n| MSSQL_PASSWORD | 密码 | - |\r\n| MSSQL_DATABASE | 数据库名 | NoBug |\r\n| MSSQL_ENCRYPT | 是否加密连接 | false |\r\n| MSSQL_TRUST_CERT | 信任服务器证书 | true |\r\n\r\n## 开发调试\r\n\r\n### 运行开发模式\r\n\r\n```bash\r\nnpm run dev\r\n```\r\n\r\n### 测试连接\r\n\r\n```bash\r\nnpm start\r\n```\r\n\r\n## 安全注意事项\r\n\r\n1. **所有配置通过环境变量管理，不要在代码中硬编码密码**\r\n2. **限制数据库用户权限**\r\n3. **在生产环境启用加密连接 (MSSQL_ENCRYPT=true)**\r\n\r\n## 故障排查\r\n\r\n### 连接失败\r\n\r\n1. 检查 SQL Server 是否允许 TCP/IP 连接\r\n2. 检查防火墙设置\r\n3. 验证用户名和密码\r\n4. 确认 SQL Server 身份验证模式\r\n\r\n### 查看详细日志\r\n\r\n在 Claude Desktop 配置中设置日志级别:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"sqlserver\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"D:\\\\work\\\\NoBug\\\\mcp-sqlserver\\\\src\\\\index.js\"],\r\n      \"env\": {\r\n        \"DEBUG\": \"*\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n","readmeFilename":"README.md","_rev":"1-3e74f67f1dc9e8f9d93bc4fee052521a"}