MCP SQL Server (開発用)

あらゆるMCP対応LLMをSQLデータベースに接続し、以下を実行するためのプロフェッショナル向けMCPサーバーです：

• クエリ (SELECT, WITH, SHOW など)

• DML (INSERT, UPDATE, DELETE)

• DDL (CREATE, ALTER, およびオプションで DROP/TRUNCATE)

このサーバーは開発支援における個人利用を目的として設計されています。

特徴

• stdio経由のMCPプロトコル（MCPクライアント互換）。

• SQLAlchemy を使用したマルチエンジン接続 (sqlite, postgresql, mysql, mssql など)。

• 日常的な操作に焦点を当てたMCPツール：

  • sql_capabilities

  • sql_list_tables

  • sql_describe_table

  • sql_run

  • sql_run_script

• デフォルトで破壊的なDDLをブロック (DROP/TRUNCATE はブロックされます)。

• 行数およびスクリプトあたりのステートメント数の制限を設定可能。

インストール

python -m venv .venv
source .venv/bin/activate
pip install -e .

設定 (環境変数)

プレフィックス: MCP_SQL_

• MCP_SQL_DATABASE_URL: SQLAlchemyのURL。デフォルト: sqlite:///./dev.db

• MCP_SQL_MAX_ROWS: クエリで返される最大行数。デフォルト: 200

• MCP_SQL_MAX_SCRIPT_STATEMENTS: スクリプトあたりの最大ステートメント数。デフォルト: 100

• MCP_SQL_ALLOW_DESTRUCTIVE_DDL: DROP および TRUNCATE を許可する場合は true/false。デフォルト: false

例

export MCP_SQL_DATABASE_URL='postgresql+psycopg://dev_user:dev_pass@localhost:5432/devdb'
export MCP_SQL_MAX_ROWS=500
export MCP_SQL_ALLOW_DESTRUCTIVE_DDL=false

サーバーの実行

mcp-sql-server

モジュールとして実行することも可能です：

python -m mcp_sql_server.server

Windowsでのダブルクリック起動

起動を容易にするために start_mcp_sql_server.bat ファイルが含まれています：

1. .venv を自動作成します（存在しない場合）。

2. 依存関係をインストール/更新します。

3. MCPサーバーを起動します。

この .bat ファイルをダブルクリックするだけです。

MCPクライアントでの設定（一般的な例）

{
  "mcpServers": {
    "sql-dev": {
      "command": "mcp-sql-server",
      "env": {
        "MCP_SQL_DATABASE_URL": "sqlite:///./dev.db",
        "MCP_SQL_MAX_ROWS": "200",
        "MCP_SQL_ALLOW_DESTRUCTIVE_DDL": "false"
      }
    }
  }
}

推奨されるフロー

1. sql_capabilities でアクティブな設定を確認する。

2. sql_list_tables でスキーマを探索する。

3. sql_describe_table でメタデータを検査する。

4. sql_run でクエリや単発のDMLを実行する。

5. sql_run_script で制御された変更バッチを実行する。

開発支援のためのベストプラクティス

• 最小限の権限を持つデータベースユーザーを使用してください。

• ローカルの開発用DBまたは使い捨てのスナップショットで作業してください。

• デフォルトでは MCP_SQL_ALLOW_DESTRUCTIVE_DDL=false を維持してください。

• 構造的な変更はマイグレーションでバージョン管理してください。

セキュリティに関する注意

このプロジェクトは本番環境向けに堅牢化されていません。開発環境におけるローカルの生産性を目的としています。

VS CodeでのClaudeガイド

設定と使用の完全な例については README_CLAUDE_VSCODE.md を確認してください。