airy

airy

データベースとやり取りするための AI ツールです。

機能：

• ターミナルでデータベースとチャットできます。
• SQL クエリを生成できます。
• MCP サーバーとして実行できます。

インストール

GitHub Releases からダウンロードしてください。

Cargo を使ってインストールします。

$ cargo install airy

ヘルプ

Usage: airy [OPTIONS] <COMMAND>

Commands:
  chat
  mcp
  help  Print this message or the help of the given subcommand(s)

Options:
      --openrouter-api-key <OPENROUTER_API_KEY>
          OpenRouter API Key [env: OPENROUTER_API_KEY=]
      --openrouter-base-url <OPENROUTER_BASE_URL>
          OpenRouter Base URL [env: OPENROUTER_BASE_URL=] [default: https://openrouter.ai/api/v1]
      --model <MODEL>
          OpenRouter model ID [env: MODEL=] [default: mistralai/devstral-small:free]
      --max-tokens <MAX_TOKENS>
          Max tokens [default: 1024]
      --mysql-url <MYSQL_URL>
          MySQL URL [env: MYSQL_URL=]
      --postgres-url <POSTGRES_URL>
          PostgreSQL URL [env: POSTGRES_URL=]
  -h, --help
          Print help
  -V, --version
          Print version

Usage: airy mcp [OPTIONS]

Options:
      --sse          Run as a server using SSE
      --port <PORT>  Set the Port [default: 8080]
  -h, --help         Print help

開発

開発環境をセットアップします。

$ just mysql-download-data # downloads test data

$ just docker-up # starts Docker containers
$ just migrate up # runs migrations to the latest version

$ just mysql-load-data # loads data into the database

チャットを実行します。

$ OPENROUTER_API_KEY=[..] cargo run -- --mysql-url "mysql://employee:[email protected]:3306/employee" chat

OPENROUTER_API_KEY、MYSQL_URL、その他の引数を環境変数として指定することもできます。

サーバー送信イベントを使って MCP サーバーを実行します。

$ cargo run -- --mysql-url "mysql://employee:[email protected]:3306/employee" mcp --sse

http://localhost:8080/sse に接続して、@modelcontextprotocol/inspector で MCP サーバーをテストできます。