MSSQL LocalDB MCP

mssql-localdb-mcp

面向 Windows 上 SQL Server Express LocalDB 的 Rust MCP 服务。让 AI Agent（Claude Desktop、Claude Code 和任何 MCP 客户端）能够完全控制 LocalDB 实例：创建和管理实例、运行任意 T-SQL 脚本、查找项目文件夹中的散落数据库文件并附加，以及检查架构。

状态：MVP（第 1 阶段）已实现功能，并通过真实 LocalDB 测试——路线图和当前阶段详见 docs/PLANNING.md。

为什么要用

现有的 SQL Server MCP 工具都假设已有配置好的远程服务，且需要外部运行时（Python、.NET、Node）。本项目：

• 单个 Rust 二进制文件，无需外部运行时，也无需 Docker。
• 专注于 LocalDB：面向本地开发工作流——在项目文件夹中查找散落的 .mdf 文件、附加文件、运行脚本，无需打开 SSMS。
• 专为 Windows 设计，并非通用的多数据库抽象。

要求

• 已安装 SQL Server Express LocalDB 的 Windows 系统（SqlLocalDB.exe 位于 PATH 中）。
• 兼容的 MCP 客户端（Claude Desktop、Claude Code 等）。

安装

通过 MCP Registry

已作为 io.github.hermessilva/mssql-localdb-mcp 发布到 官方 MCP Registry。可通过任何支持该注册表的 MCP 客户端安装。

通过 VS Code 扩展

vscode-extension/ 目录将服务打包为 VS Code 扩展，通过 MCP provider API（VS Code 1.101+）自动注册，并内置 Windows 二进制文件——无需手动下载或配置。使用以下命令在本地构建 .vsix：

./build-vsix.ps1                 # bumps the build segment; -Version x.y.z or -NoBump to control it
code --install-extension .\mssql-localdb-mcp-1.0.1-win32-x64.vsix

该扩展有自己的版本序列，与 Cargo.toml 独立——crate 版本用于 vX.Y.Z 标签和 MCP Registry 发布。

通过 Claude Code 插件

本仓库中的 claude-plugin/ 目录是一个独立的 Claude Code 插件（直接内置 Windows 二进制文件，无需单独下载）。使用以下命令直接加载：

claude --plugin-dir path\to\LocalDB-MCP\claude-plugin

该插件已提交至 claude-community marketplace 供审核——审核通过后，使用 claude plugin marketplace add anthropics/claude-plugins-community 添加市场，然后使用 claude plugin install mssql-localdb-mcp@claude-community 安装。

从源代码安装

需要安装 Rust 和 LocalDB。

git clone https://github.com/hermessilva/LocalDB-MCP.git
cd LocalDB-MCP
cargo build --release

二进制文件位于 target\release\mssql-localdb-mcp.exe。

配置 config.toml

db_scan_folder 至少需要一个明确允许的根目录——未配置时，该工具会拒绝运行。创建 %APPDATA%\mssql-localdb-mcp\config.toml：

# Windows paths in TOML need single quotes (literal string) — double
# quotes interpret \U... as a unicode escape and break parsing.
scan_allowlist = ['C:\Users\YourUser\source\repos']
scan_max_depth = 6
default_query_timeout_secs = 30
default_max_rows = 1000

在 MCP 客户端中配置

Claude Desktop / Claude Code（claude_desktop_config.json 或同等配置文件）：

{
  "mcpServers": {
    "mssql-localdb": {
      "command": "C:\\path\\to\\LocalDB-MCP\\target\\release\\mssql-localdb-mcp.exe"
    }
  }
}

通过 CLI 配置 Claude Code：

claude mcp add mssql-localdb -- "C:\path\to\LocalDB-MCP\target\release\mssql-localdb-mcp.exe"

完成后，Agent 即可使用 localdb_*、sql_* 和 db_* 工具——完整列表请参阅 docs/MCP_SPEC.md。

文档

• docs/PLANNING.md — 路线图、阶段以及各里程碑的范围。
• docs/ARCHITECTURE.md — 模块、技术决策和数据流。
• docs/MCP_SPEC.md — 所公开的每个工具、资源和提示词的确切契约。
• docs/SECURITY.md — 威胁模型和防护措施。
• CLAUDE.md — 在本仓库中工作的 AI Agent 指南。
• CONTRIBUTING.md — 贡献方式。
• CHANGELOG.md — 变更历史。

安全 — 使用前请阅读

• 仅支持 Windows 集成身份验证（不支持 SQL 身份验证）。
• 每个破坏性操作（DROP、TRUNCATE、DELETE、ALTER 等）都需要明确确认（confirm: true）——绝不会静默执行。
• 数据库发现（db_scan_folder）只会扫描 config.toml 中明确允许的文件夹（允许列表）。
• 完整详情请参阅 docs/SECURITY.md。

许可证

MIT。