SQL-Server-MCP

SQL Server MCP（Model Context Protocol）サーバー

提供された認証情報を使用して Microsoft SQL Server に接続し、スキーマのクエリと検出を行うツールを公開する、軽量な MCP stdio サーバーです。

機能

• connect：server、port、user、password、任意のdatabase、encryptを指定して接続します。
• disconnect：接続プールを閉じます。
• info：@@VERSIONを返します。
• query：任意の SQL を実行し、レコードセットを返します。
• list_databases：データベースの一覧を表示します。
• list_schemas：スキーマの一覧を表示します。
• list_tables：テーブルの一覧を表示します。任意でschemaによる絞り込みができます。

クイックスタート

• Node.js >= 18
• 依存関係をインストールしてビルドします：

  npm install
  npm run build
  

• MCP stdio サーバーとして実行します（MCP 対応クライアント向け）：

  npm start
  

サーバーは stdio 経由で起動し、MCP クライアント（Claude Desktop やその他の MCP 対応ツールなど）からの操作を待ちます。次の順序でツールを使用します：

1. SQL Server の認証情報を指定してconnectを実行します
2. info、list_*、またはqueryを実行します

MCP ツールとスキーマ

• connect の引数：

  {
    "server": "host or host\\\u005Cinstance",
    "port": 1433,
    "user": "sa",
    "password": "<secret>",
    "database": "master",
    "encrypt": true
  }
  

• query の引数：

  { "sql": "SELECT TOP 1 * FROM sys.databases" }
  { "sql": "SELECT * FROM INFORMATION_SCHEMA.TABLES" }
  

• その他のツールは引数を取らないか、任意のschemaを受け取ります。

セキュリティ

• 認証情報は呼び出し時に指定され、保存されません。安全な MCP クライアントと環境を使用してください。TLS のencryptはデフォルトで true です。

開発

• スクリプト：
  • npm run dev：ts-node で実行します
  • npm run build：JS をdist/に出力します
  • npm start：ビルド済みサーバー（dist/server.js）を実行します

コミット

• chore：TypeScript、tsconfig、依存関係を含むプロジェクトの初期構成
• feat：SQL Server ツール（connect、query、info、list_*）を備えた MCP stdio サーバーを実装
• docs：実行計画の概要と使用上の注意を追加

ライセンス

MIT