Supports configuration through environment variables loaded from .env files, allowing customization of connection settings, security parameters, timeouts, and caching behavior.
Enables deployment of the MCP server using Docker containers, with configuration via environment variables and docker-compose for simplified setup and management.
Provides access to the repository for cloning and installation, with documentation and setup instructions accessible through GitHub.
これは、SQL Serverとのやり取りのためのモデルコンテキストプロトコル（MCP）サーバーです。大規模言語モデル（LLM）がSQLクエリを実行したり、ストアドプロシージャを実行したり、強化されたセキュリティと堅牢性を備えたデータベーススキーマを探索したりできるようになります。
SELECTクエリを実行します。すべてのクエリは解析および検証され、 SELECTステートメントのみが実行されることが保証されます。SELECTのみのホワイトリスト。SQL_ALLOWED_DATABASES環境変数。pinoロガー。完全な Docker セットアップ手順については、 Docker README を参照してください。
サーバーは環境変数を使用して設定されます。ルートディレクトリに.envファイル（ .env.exampleをコピーできます）を作成し、これらの値を設定します。
すべての設定オプションとその設定方法の詳細なガイドについては、 CONFIG参照してください。
| カテゴリ | 変数 | 説明 | デフォルト（config.js から） |
|---|---|---|---|
| 繋がり | SQL_SERVER | SQL Server のホスト名または IP | localhost |
SQL_PORT | SQL Server ポート | 1433 | |
SQL_USER | SQL Server ユーザー名 | sa | |
SQL_PASSWORD | SQL Server パスワード | 必須 | |
SQL_DATABASE | 接続するデフォルトのデータベース名 | master | |
| 安全 | SQL_ENCRYPT | 暗号化を有効にする（無効にするにはfalseに設定） | true |
SQL_TRUST_SERVER_CERT | サーバー証明書を信頼する（無効にするにはfalseに設定） | true | |
SQL_ALLOWED_DATABASES | サーバーがアクセスできるデータベースのカンマ区切りリスト。空の場合、アクセス制限は緩和されます（DBユーザーの権限に依存します）。 | [] (空のリスト) | |
| タイムアウトと再試行 | SQL_CONNECTION_TIMEOUT | 接続タイムアウト（ミリ秒） | 30000 |
SQL_REQUEST_TIMEOUT | クエリのリクエストタイムアウト（ミリ秒） | 30000 | |
SQL_MAX_RETRIES | 初期接続試行の最大再試行回数 | 3 | |
SQL_INITIAL_RETRY_DELAY | 失敗した接続を再試行するまでの初期遅延（ミリ秒） | 1000 | |
SQL_MAX_RETRY_DELAY | 接続再試行の最大遅延（ミリ秒）（指数バックオフを使用） | 30000 | |
| 接続プール | SQL_POOL_MAX | プール内の最大接続数 | 10 |
SQL_POOL_MIN | プール内の最小接続数 | 0 | |
SQL_POOL_IDLE_TIMEOUT | プール内の接続のアイドル タイムアウト (ミリ秒) | 30000 | |
| キャッシング | SQL_SCHEMA_CACHE_TTL | スキーマ キャッシュの有効時間 (ミリ秒) | 300000 （5分） |
| MCPサーバー | MCP_SERVER_NAME | MCPサーバーの名前 | MSSQL Server |
MCP_SERVER_VERSION | MCP サーバーのバージョン | 1.0.0 | |
| ログ記録 | LOG_LEVEL | pinoロガーのログレベル（例： fatal 、 error 、 warn 、 info 、 debug 、 trace 、 silent ）。これはconfig.jsではなく、 server.tsのprocess.envから直接読み込まれます。 | info |
この MCP サーバーを Claude CLI に追加するには:
Claude との会話では、次のことができます。
SELECTクエリを実行します。SQL_DATABASEで操作する場合、またはSQL_ALLOWED_DATABASES単一の選択を意味する場合、 database属性はオプションです。)YourDatabaseNameを省略した場合は、環境変数で指定されたSQL_DATABASEがデフォルトになります。)この MCP サーバーは、 DatabaseServiceによって管理されるグローバルで堅牢な接続プール ( mssqlライブラリの組み込みプーリング) を利用します。
execute_query呼び出し）が、基盤となるデータベース接続と全く同じ接続を使用することを保証しません。したがって、ある呼び出しで作成された一時テーブルやセッション変数などのセッション固有の状態は、別の呼び出しでは使用できない可能性があります。各呼び出しは、セッション状態の観点からアトミックであると考える必要があります。ターゲットデータベースがプールのデフォルトと異なる場合、各操作内でUSE [database]コマンドが発行され、その特定の操作のコンテキストが確保されます。SELECTのみ: サーバーは、SQL 解析を使用して、 execute_queryツール経由でSELECTクエリのみを実行できるように厳密に制限します。DML (INSERT、UPDATE、DELETE) および DDL ステートメントはブロックされます。SQL_ALLOWED_DATABASES環境変数を使用して、サーバーが通信できるデータベースを制限します。この機能の詳細とSQL_DATABASEとの連携方法については、 DATABASE_WHITELISTING.mdご覧ください。sp_ 、 xp_ ）の直接実行、およびRECONFIGUREやWAITFOR DELAYなどのコマンドのexecute_query経由の実行はブロックされます。正当なシステム操作にはストアドプロシージャを使用してください。mssqlライブラリによって処理され、通常は SQL インジェクションを防ぐためにパラメーター化されます。問題が発生した場合:
docker logs mssql-mcp (Docker を使用している場合)。.envファイル内のすべての必須環境変数、特にSQL_PASSWORD 、 SQL_SERVER 、 SQL_USER 、およびSQL_DATABASEが正しく設定されていることを確認します。SQL_ALLOWED_DATABASESにリストされていることを確認してください。test-mcp.sh 、 test-session-persistence.sh ) のレビュー/更新が必要になる可能性があります。Docker の詳細なトラブルシューティングについては、 Docker README を参照してください。
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Claude のような大規模言語モデルが SQL クエリを実行し、データベース スキーマを探索し、SQL Server データベースへの永続的な接続を維持できるようにするモデル コンテキスト プロトコル サーバー。