← ホーム

C3DB

ブラウザ、ターミナル、または自分の AI からクライミング競技データウェアハウスを照会。

ブラウザで照会

ブラウザ上の SQL と自然言語クエリのワークスペース。インストール不要。

web コンソールを開く →

1. SQL を実行

クライアントを入れ、一度サインインし、読み取り専用 SQL を送ると表が返ります。

pip install c3db
c3db login
c3db query "SELECT * FROM event_standings WHERE final_rank = 1 LIMIT 5"
ブラウザでキーを作成・管理 →

2. ChatGPT・Gemini・Claude で使う

インストールもキーのコピーも不要です。アプリにアドレスを一つ追加し、案内に従って C3DB にサインインすれば、あとは普通の言葉で質問できます。アプリがデータベース構造を読み、SQL を書きます。

貼り付けるアドレス:

https://c3db-mcp-rt24zk2pna-uc.a.run.app/mcp

無料の C3DB アカウントが必要です。以下の手順の途中でサインイン画面が開くので、なければそこで作成してください。

Claude(claude.ai)

  1. claude.ai を開いてサインインします。
  2. 左下の自分の名前をクリックし、Settings、次に Connectors を開きます。
  3. Add custom connector をクリックします。
  4. 上のアドレスを URL 欄に貼り付け、Add をクリックします。
  5. C3DB の行の Connect をクリックし、C3DB にサインインして Allow をクリックします。
  6. チャットで + ボタンを押し、Connectors を開いて C3DB をオンにします。

Team と Enterprise プランでは、まず管理者が Admin settings で追加し、その後各メンバーが Connect を押します。

ChatGPT(chatgpt.com)

  1. chatgpt.com を開いてサインインします。
  2. Settings、Connectors、Advanced の順に開き、Developer mode をオンにします。
  3. Connectors に戻って Create をクリックします。
  4. 名前を C3DB にし、上のアドレスを server URL に貼り付けて Create をクリックします。
  5. C3DB にサインインし、Allow をクリックします。
  6. 新しいチャットで +、More、Developer mode の順に開き、C3DB をオンにします。

Developer mode は有料プラン(Pro、Business、Enterprise、Edu)が必要です。新しいチャットごとにオンにし直す必要があります。

Gemini(gemini.google.com)

  1. gemini.google.com を開き、個人の Google アカウントでサインインします。
  2. 下部の Settings & help から Connected Apps を開きます。見つからない場合は先に Personal Intelligence を開きます。
  3. Custom apps for Spark の下の Add a custom app をクリックします。
  4. 上のアドレスを貼り付けて Next をクリックします。
  5. C3DB にサインインし、Allow をクリックします。
  6. プロンプトで @ を入力して C3DB を選ぶと、Gemini がそれを使います。

Google の条件:Gemini Spark が使えること、18 歳以上、米国在住、個人アカウント、Keep Activity がオン。

3. コーディング agent で使う

コマンド一つで Claude Code か Cursor にウェアハウスを登録します。agent が自分で schema を読み SQL を書くので、model キーは不要です。先に手順 1 のクライアントを入れてください。

c3db connect claude
c3db connect cursor

Claude Code と Cursor に対応。Codex は近日対応。

4. どれも使えないとき:c3db ask

自分のモデルが SQL を書き、C3DB が実行します。Claude は `ant auth login` のサインインを利用。OpenAI、DeepSeek、GLM は provider キーを設定するか `c3db model set <provider>` を実行します。

pip install "c3db[ask]"
c3db ask "who has the most World Cup golds in lead?"

🔒 モデルの API キーは端末内(環境変数か ~/.config/c3db)にのみ存在し、C3DB に送信されません。

Python SDK

Client().query() は pandas DataFrame を返します。Client().ask() は自分のモデルに SQL を書かせます。

from c3db import Client

df = Client().query("SELECT athlete_name, count(*) AS golds "
                    "FROM event_standings WHERE final_rank = 1 "
                    "GROUP BY 1 ORDER BY 2 DESC")

# or let your own model write the SQL:
df = Client().ask("who has the most World Cup golds in lead?")

コマンド

コマンド説明
c3db loginC3DB データキーを検証して保存します。
c3db query "<sql>"読み取り専用 SQL クエリを実行(-f ファイル / stdin;--format table|csv|json)。
c3db ask "<question>"自然言語で質問。SQL は自分のモデルが書きます。pip install "c3db[ask]" が必要。
c3db connect claudeホスト型 MCP を Claude Code や Cursor に登録します。
c3db schemaクエリ規約と正式な BigQuery DDL を表示します。