USQLMCP

usqlmcp

ユニバーサル SQL MCP（Model Context Protocol）です。

機能

• ツール

  • read_query：SELECT クエリを実行し、結果を返します。
  • write_query：INSERT、UPDATE、DELETE、または ALTER クエリを実行し、影響を受けた行数を返します。
  • create_table：CREATE TABLE クエリを実行し、データベースに新しいテーブルを定義します。
  • describe_table_schema：サポートされているすべてのデータベースについて、列名やデータ型を含む指定テーブルの JSON スキーマを取得します。

• リソース

  • usqlmcp://<table>/schema：データベース内の任意のテーブルのスキーマに JSON リソースとしてアクセスします。
  • 各テーブルの個別のスキーマリソースは、自動的に検出され登録されます。

インストール

usqlmcp は[リリース経由で][]入手できます。

リリース経由でのインストール

1. お使いのプラットフォーム向けのリリースをダウンロードします
2. .tar.bz2 または .zip ファイルから usqlmcp または usqlcmp.exe ファイルを展開します
3. 展開した実行ファイルを、$PATH（Linux/macOS）または %PATH%（Windows）内の任意の場所に移動します

セットアップ

Cursor での MCP 統合

以下の設定を ~/.cursor/mcp.json ファイルに追加するか、Cursor の設定メニューから設定してください。

{
    "mcpServers": {
        "usqlmcp": {
            "command": "usqlmcp",
            "args": ["--dsn", "sqlite3:///your/db/dsn/file.db"]
        }
    }
}

その他のツール

{
    "servers": {
        "usqlmcp": {
            "type": "stdio",
            "command": "usqlmcp",
            "args": ["--dsn", "sqlite3:///your/db/dsn/file.db"]
        }
    }
}

Docker の使用

MCP JSON 設定で適切なコマンドと引数を指定することで、Cursor で usqlmcp を Docker 経由で実行するように設定できます。

例：Postgres（Docker）

以下を ~/.cursor/mcp.json に追加します。

{
    "mcpServers": {
        "usqlmcp": {
            "command": "docker",
            "args": [
                "run", "-i", "--rm",
                "ghcr.io/thesoulless/usqlmcp:latest",
                "--dsn", "postgres://username:[email protected]:5432/dbname?sslmode=disable"
            ]
        }
    }
}

注：ホストマシン上のデータベースに接続するときは、localhost または 127.0.0.1 の代わりに host.docker.internal を使用してください。

例：ボリュームマウントを使用した SQLite（Docker）

ローカルマシンの SQLite データベースファイルを使用するには、以下を ~/.cursor/mcp.json に追加します。

{
    "mcpServers": {
        "usqlmcp": {
            "command": "docker",
            "args": [
                "run", "-i", "--rm",
                "-v", "/path/to/local/mydatabase.db:/data/mydatabase.db",
                "ghcr.io/thesoulless/usqlmcp:latest",
                "--dsn", "sqlite3:///data/mydatabase.db"
            ]
        }
    }
}

これにより、ローカルの SQLite データベースファイルがコンテナに直接マウントされ、必要なものだけにアクセスできるようになります。

謝辞

このプロジェクトは、SQL データベース向けのユニバーサルなコマンドラインインターフェースである usql に依存しています。