MCP MSSQL Server

MCP MSSQL Server

NestJS で構築された、Microsoft SQL Server 統合用の MCP（Model Context Protocol）サーバーです。このサーバーを使用すると、Claude Code やその他の MCP クライアントが、標準化されたツールを通じて SQL Server データベースを操作できます。

機能

• MCP プロトコルのサポート：SQL Server 操作用の Model Context Protocol を完全に実装
• Windows 認証：Windows（NTLM）認証と SQL Server 認証の両方に対応
• 包括的な SQL ツール：クエリの実行、スキーマの確認、テーブルの管理、ストアドプロシージャの実行
• ヘルスモニタリング：データベース接続用のヘルスチェックを内蔵
• コネクションプーリング：効率的なデータベース接続管理

MCP ツール

サーバーは以下の SQL 操作を MCP ツールとして公開します。

• execute-query：パラメーターに対応した SQL クエリの実行
• get-schema：データベースのスキーマ情報の取得
• list-tables：データベース内のすべてのテーブルの一覧表示
• describe-table：制約を含むテーブル構造の詳細の取得
• get-table-data：フィルタリングに対応したページ分割テーブルデータの取得
• execute-procedure：パラメーターを指定したストアドプロシージャの実行

インストール

npm install

設定

データベース設定を記述した .env ファイルを作成します。

# SQL Server Connection
MSSQL_HOST=localhost
MSSQL_PORT=1433
MSSQL_DATABASE=your_database

# Authentication Mode (choose one)
# For SQL Server Authentication:
MSSQL_USERNAME=your_username
MSSQL_PASSWORD=your_password

# For Windows Authentication:
MSSQL_WIN_AUTH=true
MSSQL_DOMAIN=your_domain
MSSQL_USERNAME=domain\username
MSSQL_PASSWORD=your_password

# Connection Options
MSSQL_ENCRYPT=true
MSSQL_TRUST_CERT=true

# Server Port
PORT=3000

開発

# Start in development mode
npm run start:dev

# Start with debugging
npm run start:debug

# Build the application
npm run build

# Start production build
npm run start:prod

テスト

# Unit tests
npm run test

# Watch mode
npm run test:watch

# End-to-end tests
npm run test:e2e

# Test coverage
npm run test:cov

コード品質

# Run ESLint with auto-fix
npm run lint

# Format code with Prettier
npm run format

MCP エンドポイント

サーバーの実行中（デフォルトのポートは 3000）：

• MCP プロトコル：http://localhost:3000/mssql/mcp
• SSE（Claude Code）：http://localhost:3000/mssql/sse
• ヘルスチェック：http://localhost:3000/mssql/health

Claude Code での使用方法

1. MCP サーバーを起動します：npm run start:dev
2. 次の接続先を使用するように Claude Code を設定します：http://localhost:3000/mssql/mcp
3. Claude Code の MCP インターフェースから公開された SQL ツールを使用します

アーキテクチャ

• MCPModule：/mssql 名前空間で MCP プロトコルの実装を処理
• DatabaseModule：SQL Server への接続と認証を管理
• HealthModule：データベースのヘルスモニタリングを提供
• REST エンドポイントなし：すべての機能は MCP ツールのみを通じて公開

ライセンス

ISC