MSSQL LocalDB MCP

mssql-localdb-mcp

Windows 上の SQL Server Express LocalDB 向け Rust 製 MCP サーバーです。AI エージェント（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/ ディレクトリには、MCP プロバイダー API（VS Code 1.101+）を通じてサーバーを自動登録する VS Code 拡張機能が含まれています。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 とは独立したバージョン系列があります。vX.Y.Z タグと MCP Registry への公開に使用されるのは、クレートのバージョンです。

Claude Code プラグイン経由

このリポジトリの claude-plugin/ ディレクトリには、自己完結型の Claude Code プラグインが含まれています（Windows バイナリを直接同梱しており、別途ダウンロードする必要はありません）。次のコマンドで直接読み込みます。

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

claude-community マーケットプレイスに審査を申請済みです。承認後は、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 を使用するには、少なくとも 1 つのルートフォルダーを明示的に許可する必要があります。許可されていない場合、ツールは実行を拒否します。%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"

これで、エージェントから localdb_*、sql_*、db_* ツールを利用できます。ツールの一覧は、docs/MCP_SPEC.md を参照してください。

ドキュメント

• docs/PLANNING.md — ロードマップ、フェーズ、各マイルストーンの範囲。
• docs/ARCHITECTURE.md — モジュール、技術的な決定、データフロー。
• docs/MCP_SPEC.md — 公開されるすべてのツール／リソース／プロンプトの厳密な仕様。
• docs/SECURITY.md — 脅威モデルと安全対策。
• CLAUDE.md — このリポジトリで作業する AI エージェント向けガイド。
• CONTRIBUTING.md — コントリビューションの方法。
• CHANGELOG.md — 変更履歴。

セキュリティ — 使用前にお読みください

• Windows 統合認証のみを使用します（SQL 認証は使用しません）。
• 破壊的な操作（DROP、TRUNCATE、DELETE、ALTER など）には、明示的な確認（confirm: true）が必要です。確認なしで実行されることはありません。
• データベースの検索（db_scan_folder）では、config.toml で明示的に許可されたフォルダーのみをスキャンします（許可リスト）。
• 詳細は docs/SECURITY.md を参照してください。

ライセンス

MIT。