SQL Serverの監視、診断、データベース操作のための本番環境対応MCP（Model Context Protocol）サーバー。.NET 9とMicrosoft.Data.SqlClientを使用して構築されており、ODBCドライバーを必要としないネイティブなSQL Server接続を実現します。
セッション管理 — Extended Eventsセッションの作成、開始、停止、削除、一覧表示
スマートフィルタリング — アプリケーション、データベース、ユーザー、期間、ホスト、テキストパターンによるフィルタリング
クエリフィンガープリント — リテラル値のみが異なる類似クエリを正規化してグループ化
シーケンス分析 — タイミングギャップと累積時間を含む実行順序のトレース
デッドロック検出 — 被害者/プロセス詳細を含むXMLデッドロックレポートのキャプチャと分析
ブロッキング分析 — 待機リソースとSQLテキストを含むブロックされたプロセスイベントの監視
待機統計 — sys.dm_os_wait_stats を直接照会し、タイプ（CPU、I/O、Lock、Memoryなど）ごとに分類
ヘルスチェック — 遅いクエリ、デッドロック、ブロッキング、待機統計、インサイトを含む包括的なサーバー診断
リアルタイムストリーミング — 指定した期間、キャプチャしたイベントをストリーミング
本番環境に安全 — ノイズを自動的に除外（sp_reset_connection、SETステートメント、トレースクエリ）
データベース操作 — テーブルの一覧表示、スキーマの説明、データの照会、挿入、更新、テーブルの削除
AI最適化 — オプションのMarkdownフォーマットによる構造化JSON出力
Related MCP server: mysql-mcp-server
Extended Eventsが有効なSQL Server 2012+（デフォルト）
必要な権限:
GRANT ALTER ANY EVENT SESSION TO [your_login];
GRANT VIEW SERVER STATE TO [your_login];ブロックされたプロセスの検出には:
EXEC sp_configure 'show advanced options', 1;
RECONFIGURE;
EXEC sp_configure 'blocked process threshold', 5;
RECONFIGURE;.NET SDKは不要です。Dockerがインストールされている任意のシステムで動作します。
docker pull ghcr.io/tkmawarire/sql-sentinel-mcp:latestclaude_desktop_config.json){
"mcpServers": {
"sql-sentinel": {
"command": "docker",
"args": ["run", "-i", "--rm", "--network", "host",
"-e", "SQL_SENTINEL_CONNECTION_STRING=Server=localhost;Database=master;User Id=sa;Password=YourPassword;TrustServerCertificate=true",
"ghcr.io/tkmawarire/sql-sentinel-mcp:latest"]
}
}
}claude mcp add sql-sentinel \
-e SQL_SENTINEL_CONNECTION_STRING="Server=localhost;Database=master;User Id=sa;Password=YourPassword;TrustServerCertificate=true" \
-- docker run -i --rm --network host \
-e SQL_SENTINEL_CONNECTION_STRING \
ghcr.io/tkmawarire/sql-sentinel-mcp:latestネットワークアクセス: stdioトランスポートには
-iフラグが必要です。ホストマシン上のSQL Serverにコンテナが到達できるように--network hostを使用してください。リモートSQL Serverの場合は、--network hostを省略し、接続文字列でアクセス可能なホスト名を使用してください。接続文字列:
-eでSQL_SENTINEL_CONNECTION_STRINGを設定します。すべてのツールはこの環境変数から接続文字列を読み取ります。
.NET 9 SDK以降が必要です。
dotnet tool install -g Neofenyx.SqlSentinel.Mcp{
"mcpServers": {
"sql-sentinel": {
"command": "sql-sentinel-mcp",
"env": {
"SQL_SENTINEL_CONNECTION_STRING": "Server=localhost;Database=master;User Id=sa;Password=YourPassword;TrustServerCertificate=true"
}
}
}
}git clone https://github.com/tkmawarire/sql-sentinel.git
cd sql-sentinel
dotnet build直接実行:
dotnet run --project SqlServer.Profiler.Mcp/または、自己完結型の単一バイナリを発行:
# Windows
dotnet publish SqlServer.Profiler.Mcp/ -c Release -r win-x64 --self-contained
# Linux
dotnet publish SqlServer.Profiler.Mcp/ -c Release -r linux-x64 --self-contained
# macOS (Apple Silicon)
dotnet publish SqlServer.Profiler.Mcp/ -c Release -r osx-arm64 --self-contained
# macOS (Intel)
dotnet publish SqlServer.Profiler.Mcp/ -c Release -r osx-x64 --self-contained出力は bin/Release/net9.0/{runtime}/publish/ に配置されます。
すべてのツールは SQL_SENTINEL_CONNECTION_STRING 環境変数から接続文字列を読み取ります。サーバーを起動する前に一度設定してください:
export SQL_SENTINEL_CONNECTION_STRING="Server=localhost;Database=master;User Id=sa;Password=YourPassword;TrustServerCertificate=false;Encrypt=true"SQL認証:
Server=localhost;Database=master;User Id=sa;Password=YourPassword;TrustServerCertificate=false;Encrypt=trueWindows認証:
Server=localhost;Database=master;Integrated Security=true;TrustServerCertificate=false;Encrypt=true注:
TrustServerCertificate=trueは、自己署名証明書を使用する開発環境でのみ使用してください。 本番環境では、常にTrustServerCertificate=falseを有効なSSL証明書と共に使用してください。
Azure SQL:
Server=yourserver.database.windows.net;Database=yourdb;User Id=user;Password=password;Encrypt=trueTool | Description |
| フィルター付きExtended Eventsセッションを作成（開始はしない） |
| 既存のセッションでイベントのキャプチャを開始 |
| キャプチャを停止。イベントは保持される |
| セッションを削除し、すべてのイベントを破棄 |
| MCPで作成されたすべてのセッションを状態とバッファ使用量とともに一覧表示 |
| セッションの作成と開始を1つのステップで行う |
Tool | Description |
| フィルタリング、並べ替え、重複排除を備えたキャプチャ済みイベントの取得 |
| フィンガープリント、データベース、アプリ、またはログインでグループ化された集計統計 |
| タイミングとギャップを含むクエリ実行シーケンスの分析 |
| データベース、アプリケーション、ログイン、セッション、ブロッキング情報の一覧表示 |
| 指定した期間（1〜300秒）のリアルタイムイベントキャプチャ |
Tool | Description |
| 被害者、プロセス、ロック、SQLテキストを含むデッドロックイベントの取得 |
| 待機リソースとSQLテキストを含むブロックされたプロセスイベントの取得 |
| タイプごとに分類された |
| 包括的なレポート: 遅いクエリ、デッドロック、ブロッキング、待機統計、インサイト |
Tool | Description |
| 現在のログイン権限とブロックされたプロセスのしきい値設定を確認 |
| ログインに必要な権限を付与（sysadminが必要） |
Tool | Description |
| データベース内のすべてのユーザーテーブルを一覧表示（スキーマ修飾） |
| 詳細なテーブルスキーマ: 列、インデックス、制約、外部キー |
| CREATE TABLEステートメントで新しいテーブルを作成 |
| INSERTステートメントでデータを挿入 |
| SELECTクエリを実行して結果を返す |
| UPDATEステートメントでデータを更新 |
| DROP TABLEステートメントでテーブルを削除 |
Agent: sqlsentinel_quick_capture(
sessionName: "debug_api",
applications: "MyWebApp",
minDurationMs: 100
)
// User triggers the slow operation
Agent: sqlsentinel_get_events(
sessionName: "debug_api",
sortBy: "DurationDesc",
limit: 20
)
Agent: sqlsentinel_drop_session(sessionName: "debug_api")Agent: sqlsentinel_quick_capture(
sessionName: "n_plus_one_check",
databases: "OrdersDB"
)
// User loads a page
Agent: sqlsentinel_get_stats(
sessionName: "n_plus_one_check",
groupBy: "QueryFingerprint"
)
// Look for queries with high execution countsAgent: sqlsentinel_analyze_sequence(
sessionName: "my_session",
correlationId: "order-12345",
responseFormat: "Markdown"
)Agent: sqlsentinel_quick_capture(
sessionName: "deadlock_monitor",
eventTypes: "Deadlock"
)
// Wait for deadlocks to occur
Agent: sqlsentinel_get_deadlocks(
sessionName: "deadlock_monitor",
responseFormat: "Markdown"
)Agent: sqlsentinel_quick_capture(
sessionName: "blocking_check",
eventTypes: "BlockedProcess"
)
// Requires: sp_configure 'blocked process threshold', 5
Agent: sqlsentinel_get_blocking(
sessionName: "blocking_check",
responseFormat: "Markdown"
)Agent: sqlsentinel_health_check(
sessionName: "my_session",
slowQueryThresholdMs: 1000,
responseFormat: "Markdown"
)Agent: sqlsentinel_list_tables()
Agent: sqlsentinel_describe_table(
name: "dbo.Products"
)
Agent: sqlsentinel_read_data(
sql: "SELECT TOP 10 * FROM dbo.Products ORDER BY CreatedDate DESC"
)Agent: sqlsentinel_get_wait_stats(
topN: 20,
responseFormat: "Markdown"
)類似したクエリをグループ化するためにクエリが正規化されます:
-- These become one fingerprint:
SELECT * FROM Users WHERE id = 123
SELECT * FROM Users WHERE id = 456
-- Fingerprint: abc123:SELECT * FROM Users WHERE id = ?
-- Execution count: 2デフォルトで除外されるパターン（excludeNoise=true の場合）:
sp_reset_connection — コネクションプールのリセット
SET TRANSACTION ISOLATION LEVEL — セッション設定
SET NOCOUNT, SET ANSI_* — クライアント設定
sp_trace_*, fn_trace_* — トレースシステムクエリ
SqlBatchCompleted, RpcCompleted, SqlStatementCompleted, SpStatementCompleted, Attention, ErrorReported, Deadlock, BlockedProcess, LoginEvent, SchemaChange, Recompile, AutoStats
sql-profiler-mcp/
├── .github/
│ └── workflows/
│ ├── docker.yml # Build & push multi-arch Docker images
│ └── publish-mcp-registry.yml # Publish NuGet + MCP registry
├── .mcp/
│ └── server.json # MCP manifest (NuGet + OCI packages)
├── SqlServer.Profiler.Mcp/ # Main MCP server (stdio transport)
│ ├── SqlServer.Profiler.Mcp.csproj
│ ├── Program.cs # Entry point, DI setup, MCP config
│ ├── Models/
│ │ ├── ProfilerModels.cs # Records, enums, data models
│ │ └── DbOperationResult.cs # Result model for CRUD operations
│ ├── Services/
│ │ ├── ProfilerService.cs # Core Extended Events logic
│ │ ├── QueryFingerprintService.cs # SQL normalization & fingerprinting
│ │ ├── WaitStatsService.cs # DMV-based wait stats analysis
│ │ ├── SessionConfigStore.cs # In-memory session config storage
│ │ └── EventStreamingService.cs # Real-time event streaming
│ ├── Utilities/
│ │ └── SqlInputValidator.cs # SQL input validation & escaping
│ └── Tools/
│ ├── SessionManagementTools.cs # Session lifecycle tools (6)
│ ├── EventRetrievalTools.cs # Event retrieval tools (5)
│ ├── DiagnosticTools.cs # Diagnostic tools (4)
│ ├── PermissionTools.cs # Permission tools (2)
│ └── DatabaseTools.cs # Database CRUD tools (7)
├── SqlServer.Profiler.Mcp.Api/ # Debug REST API (Swagger on port 5100)
│ ├── SqlServer.Profiler.Mcp.Api.csproj
│ ├── Program.cs
│ ├── Controllers/
│ │ └── ProfilerController.cs
│ ├── Models/
│ │ └── RequestModels.cs
│ └── appsettings.json
├── SqlServer.Profiler.Mcp.Cli/ # Debug CLI (REPL + script mode)
│ ├── SqlServer.Profiler.Mcp.Cli.csproj
│ └── Program.cs
├── SqlServer.Profiler.Mcp.Tests/ # xUnit tests for core MCP library (228 tests)
│ └── ...
├── SqlServer.Profiler.Mcp.Api.Tests/ # xUnit tests for API project (29 tests)
│ └── ...
├── Dockerfile # Multi-stage build (bookworm-slim)
├── .dockerignore
├── SqlServer.Profiler.Mcp.slnx # Solution file
├── CLAUDE.md
├── CONTRIBUTING.md
└── README.mdSQL Server 2012+ インスタンス（ローカル、Docker、またはリモート）
Docker（オプション、コンテナビルド用）
git clone https://github.com/tkmawarire/sql-sentinel.git
cd sql-sentinel
dotnet restore
dotnet builddotnet run --project SqlServer.Profiler.Mcp/サーバーはMCPプロトコルを使用してstdio上で通信します。対話的に使用するには、MCPクライアント（Claude Desktop、Claude Codeなど）に接続してください。
APIプロジェクトは、すべてのMCPツールのRESTラッパーと、手動テスト用のSwagger UIを提供します。
dotnet run --project SqlServer.Profiler.Mcp.Api/Swagger UI: http://localhost:5100/
環境変数 SQL_SENTINEL_CONNECTION_STRING で接続文字列を設定
CLIプロジェクトは、ツールを直接テストするための対話型REPLとスクリプトモードを提供します。
# Interactive REPL mode
dotnet run --project SqlServer.Profiler.Mcp.Cli/
# List all available tools
dotnet run --project SqlServer.Profiler.Mcp.Cli/ list
# Get help for a specific tool
dotnet run --project SqlServer.Profiler.Mcp.Cli/ help sqlsentinel_quick_capture
# Execute a single tool
dotnet run --project SqlServer.Profiler.Mcp.Cli/ call sqlsentinel_list_sessions実行前に SQL_SENTINEL_CONNECTION_STRING 環境変数を設定してください。
docker build -t sql-sentinel-mcp:test .
docker run -i --rm --network host sql-sentinel-mcp:test依存性注入 — Microsoft.Extensions.Hosting による
stdioトランスポート — stdoutはMCPプロトコル用に予約されており、すべてのロギングはstderrに出力されます
ツールの自動検出 — MCPツールは WithToolsFromAssembly() を使用してアセンブリから検出されます
XEセッションプレフィックス — 作成されたすべてのセッションには mcp_sentinel_ というプレフィックスが付きます
2つのイベント形状 — 型付きフィールドを持つ標準イベント（クエリ、ログイン、再コンパイル）と、Extended Events XMLから解析されるXMLペイロードイベント（デッドロック、ブロッキング）
Tools/ 配下の適切なファイルに public static メソッドを作成します（または新しいファイルを作成）
[McpServerTool(Name = "sqlsentinel_your_tool")] と [Description("...")] を付与します
[Description("...")] 属性を持つパラメータを追加します — これらがツールの入力スキーマになります
メソッドパラメータでサービスを注入します（例: IProfilerService、IWaitStatsService）
文字列（JSONまたはMarkdown）を返します — フレームワークがMCPレスポンスのラッピングを処理します
[McpServerTool(Name = "sqlsentinel_example")]
[Description("Description shown to AI agents")]
public static async Task<string> Example(
IProfilerService profilerService,
[Description("Optional filter")] string? filter = null)
{
var connectionString = ConnectionStringResolver.Resolve();
// Implementation
return JsonSerializer.Serialize(result);
}GRANT ALTER ANY EVENT SESSION TO [your_login];
GRANT VIEW SERVER STATE TO [your_login];接続文字列の資格情報を確認してください
Windows認証の場合、プロセスが正しいユーザーで実行されていることを確認してください
Azure SQLの場合、ファイアウォールがお使いのIPを許可していることを確認してください
セッションがRUNNING状態であることを確認してください（sqlsentinel_list_sessions）
フィルターが厳しすぎないか確認してください
対象のデータベース/アプリがクエリを生成しているか確認してください
minDurationMs がすべてをフィルタリングしていないか確認してください
セッションが eventTypes: "Deadlock" で作成されていることを確認してください
セッションの実行中に実際にデッドロックが発生する必要があります
blocked process threshold が設定されていることを確認してください: sp_configure 'blocked process threshold', 5
セッションが eventTypes: "BlockedProcess" で作成されていることを確認してください
ブロッキングが設定されたしきい値（秒）を超える必要があります
多数のイベントを含む大きなリングバッファは解析に時間がかかる場合があります。以下を使用してください:
時間フィルターで対象期間を絞り込む
必要に応じてコード内のコマンドタイムアウトを増やす
SQL_SENTINEL_CONNECTION_STRING 環境変数には資格情報が含まれます — 適切に保護してください
本番環境でセッションを無期限に実行したままにしないでください
クエリテキストには機密データが含まれる場合があります
必要最小限の権限を付与してください
問題やプルリクエストの提出に関するガイドラインは CONTRIBUTING.md を参照してください。
MIT
This server cannot be deployed
Hosted MCP server for PostgreSQL diagnostics: slow queries, missing indexes, connection pressure.
2,000+ MCP servers read at source level. Know what one does before you connect. Free, no key.
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
