SQL Server

mcp-sqlserver

SQL Server 用の MCP（Model Context Protocol）サーバーです。権限制御に対応し、デフォルトで読み取り専用モードで動作します。AI エージェント（Claude、opencode、その他の MCP クライアント）が SQL Server データベースを安全に参照・管理できます。

セキュリティ

• 認証情報が LLM に公開されることはありません — 接続文字列は環境から読み込まれ、応答やログに表示されることはありません。
• デフォルトで読み取り専用 — consulta ツールは DDL/DML（INSERT、UPDATE、DELETE、DROP など）をブロックします。
• 必要に応じて書き込み — 書き込みツール（executar_update、executar_ddl など）は、接続ユーザーが書き込み権限（roles sysadmin、db_owner、db_datawriter、db_ddladmin）を持つ場合にのみ公開され、実行のたびに明示的な確認が必要です。

前提条件

• Python 3.10+
• ODBC Driver 18 for SQL Server ドライバー：
  • macOS：brew install msodbcsql18
  • Windows/Linux：Microsoft の対応するドライバーをインストールしてください

インストール

PyPI 経由：

pip install sqlserver-mcp-tools

または、インストールせずに実行（キャッシュを使用して PyPI から直接実行）：

uvx --from sqlserver-mcp-tools mcp-sqlserver

設定

サーバーは、以下の優先順位で接続文字列を読み込みます。

1. 環境変数 MSSQL_CONNECTION_STRING
2. .env ファイルを指定する環境変数 MSSQL_ENV_FILE
3. 作業ディレクトリ（またはプロジェクトのルート）にある .env ファイル

接続文字列の例：

DRIVER={ODBC Driver 18 for SQL Server};SERVER=localhost,1433;DATABASE=seu_banco;UID=seu_usuario;PWD=sua_senha;TrustServerCertificate=yes

MCP クライアントでの使用

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "mcp-sqlserver": {
      "command": "uvx",
      "args": ["--from", "sqlserver-mcp-tools", "mcp-sqlserver"],
      "env": {
        "MSSQL_CONNECTION_STRING": "DRIVER={ODBC Driver 18 for SQL Server};SERVER=...;DATABASE=...;UID=...;PWD=...;TrustServerCertificate=yes"
      }
    }
  }
}

pip install でインストールした場合は、エントリーポイントを直接使用できます：

{
  "mcpServers": {
    "mcp-sqlserver": {
      "command": "mcp-sqlserver",
      "env": {
        "MSSQL_CONNECTION_STRING": "DRIVER={ODBC Driver 18 for SQL Server};SERVER=...;DATABASE=...;UID=...;PWD=...;TrustServerCertificate=yes"
      }
    }
  }
}

OpenCode

プロジェクトの opencode.json に記述します：

{
  "mcp": {
    "sqlserver": {
      "type": "local",
      "command": ["mcp-sqlserver"],
      "environment": {
        "MSSQL_CONNECTION_STRING": "DRIVER={ODBC Driver 18 for SQL Server};SERVER=...;DATABASE=...;UID=...;PWD=...;TrustServerCertificate=yes"
      }
    }
  }
}

別の方法として、ローカルの .env ファイルを指定し、パスワードを JSON に含めないようにできます：

{
  "mcp": {
    "sqlserver": {
      "type": "local",
      "command": ["mcp-sqlserver"],
      "environment": {
        "MSSQL_ENV_FILE": "/caminho/para/seu/.env"
      }
    }
  }
}

HTTP サーバー（Streamable HTTP）

ローカルモード（stdio）に加えて、サーバーを Streamable HTTP 経由の リモート MCP サーバー として実行し、/mcp エンドポイントを公開できます。server エクストラを指定してインストールしてください：

pip install 'sqlserver-mcp-tools[server]'

サーバーを起動します：

MSSQL_CONNECTION_STRING="DRIVER={ODBC Driver 18 for SQL Server};SERVER=...;DATABASE=...;UID=...;PWD=...;TrustServerCertificate=yes" \
  mcp-sqlserver-http

必要に応じて、MCP_HOST（デフォルトは 0.0.0.0）と MCP_PORT（デフォルトは 8090）でホスト／ポートを設定できます。MCP エンドポイントは http://<host>:<porta>/mcp です。

opencode からリモート接続するには：

{
  "mcp": {
    "sqlserver": {
      "type": "remote",
      "url": "http://10.177.51.228:8090/mcp"
    }
  }
}

使用可能なツール

読み取り専用（常に使用可能）：

ツール	説明
consulta	SELECT を実行します（読み取り専用、DDL/DML をブロック）
listar_bancos	アクセス可能なデータベースを一覧表示します
listar_tabelas	データベース内のテーブルとビューを一覧表示します
descrever_tabela	テーブルの構造（列、型、PK）を表示します
listar_indices	テーブルのインデックスを一覧表示します
listar_procedures	ストアドプロシージャを一覧表示します
ler_procedure	プロシージャのソースコードを表示します
listar_funcoes	関数（スカラー関数およびテーブル値関数）を一覧表示します
ler_funcao	関数のソースコードを表示します
listar_constraints	テーブルの制約（PK、FK、UNIQUE、CHECK、DEFAULT）を一覧表示します
estatisticas_tabela	統計情報（行数、サイズ、データ使用量）を表示します
plano_execucao	推定実行プランを表示します（実行はしません）
status_jobs	SQL Agent ジョブの最終実行ステータスを表示します

書き込み（接続に書き込み権限がある場合のみ）：

ツール	説明
executar_procedure	ストアドプロシージャを実行します
executar_update	UPDATE を実行します（WHERE が必要です）
criar_indice	インデックスを作成します
alterar_procedure	自動バックアップ付きでプロシージャを変更します
executar_ddl	ロールバック用スクリプトをバックアップして DDL を実行します

ライセンス

MIT