MCP Sql

🚀 mcp-sql

LLMがPostgreSQL、SQLite、MySQLデータベースをクエリできるMCPサーバーです。シングルバイナリで、デフォルトで読み取り専用、複数データベースに対応しています。

🚀 クイックスタート

このセクションでは、mcp-sqlの基本的な使い方を説明します。

📦 インストール

以下のコマンドを使用して、mcp-sqlをインストールできます。

cargo install mcp-sql

💻 使用例

基本的な使用法

# デモモード — サンプルデータですぐに試す
mcp-sql --demo

# 単一データベース
mcp-sql --url postgres://user:pass@localhost/mydb

# SQLite
mcp-sql --url sqlite:path/to/db.sqlite

# 複数データベース
mcp-sql --url postgres://localhost/app --url sqlite:analytics.db

# 書き込み操作を有効にする
mcp-sql --url sqlite:local.db --allow-write

# カスタム行制限
mcp-sql --url mysql://user:pass@localhost/shop --row-limit 500

# 環境変数からURLを読み取る
mcp-sql --url-env DATABASE_URL

# --urlと--url-envを混在させる
mcp-sql --url sqlite:local.db --url-env PROD_DB_URL

# カスタムクエリタイムアウト (デフォルト: 30s)
mcp-sql --url sqlite:local.db --query-timeout 60

📚 詳細ドキュメント

Claude Code

claude mcp add sql -- mcp-sql --url sqlite:path/to/your.db

または、直接~/.claude.jsonを編集します。

{
  "mcpServers": {
    "sql": {
      "type": "stdio",
      "command": "mcp-sql",
      "args": ["--url", "sqlite:path/to/your.db"]
    }
  }
}

Claude Desktop

Claude Desktopの設定ファイル (macOSでは~/Library/Application Support/Claude/claude_desktop_config.json) に追加します。

{
  "mcpServers": {
    "sql": {
      "command": "mcp-sql",
      "args": [
        "--url", "postgres://user:pass@localhost/mydb",
        "--url", "sqlite:analytics.db"
      ]
    }
  }
}

Cursor / VS Code

MCPの設定ファイル (.cursor/mcp.json または同等のファイル) に追加します。

{
  "mcpServers": {
    "sql": {
      "command": "mcp-sql",
      "args": ["--url", "sqlite:path/to/your.db"]
    }
  }
}

🔧 ツール

複数のデータベースが接続されている場合、すべてのツールはオプションのdatabaseパラメータを受け付けます。接続されているデータベースが1つだけの場合は、自動的にそれが使用されます。

🔧 CLIオプション

--demoを使用しない限り、少なくとも1つの--urlまたは--url-envが必要です。

🔒 セキュリティ

• デフォルトで読み取り専用 — SELECT、WITH、SHOW、PRAGMA、EXPLAINクエリのみが許可されます。
• 行制限が適用される — LIMITが存在しない場合は自動的に挿入されます (デフォルト: 100)。
• クエリタイムアウト — 設定されたタイムアウト時間後にクエリがキャンセルされます (デフォルト: 30s)。
• 資格情報が隠される — list_databasesの出力でパスワードがマスクされます。
• PostgreSQL/MySQL — データベースレベルでSET TRANSACTION READ ONLYが使用されます。

--allow-writeを指定すると、INSERT、UPDATE、DELETE、CREATE、DROP操作が有効になります。

🔧 サポートされるデータベース

📄 ライセンス

Apache License, Version 2.0 または MIT License のいずれかを選択してライセンスを取得できます。