エージェント向け

MCP サーバー

stdio 上の 40 ツール。いつも話しているアシスタントが、データベース作業を説明するのではなく実行します。

01

これは何か

@capydb/mcp として公開されている Model Context Protocol サーバーです。stdio を話し、ローカルで動き、ダッシュボードや CLI と同じコントロールプレーン API を、同じ組織スコープ・同じ権限・同じ監査証跡で呼び出します。

実行時に SDK へ依存せず手書きのクライアントを同梱しているため、インストールは小さく、起動は一瞬です。

02

インストール

任意の MCP クライアントのサーバー設定に追加してください。認証はサーバー自身が処理します。キーなしで最初に使うと、ブラウザーで承認するためのデバイスログイン URL を返します。

{
  "mcpServers": {
    "capydb": {
      "command": "npx",
      "args": ["-y", "@capydb/mcp"],
      "env": { "CAPYDB_API_KEY": "capy_live_..." }
    }
  }
}

03

クライアント

  • -Claude Code と Claude デスクトップアプリ
  • -Cursor、Windsurf、その他 MCP に対応するエディター
  • -stdio で Model Context Protocol を実装するあらゆるクライアント。サーバーは現行と旧来の両方のプロトコル版を提供します
  • -任意の MCP SDK を使った自作エージェント

04

ツールの守備範囲

  • -プロジェクト:一覧、作成、参照、名称変更、一時停止、再開、削除
  • -接続:直接/プールの接続文字列の取得、認証情報のローテーション
  • -SQL:プロジェクトに対してクエリや文を実行し、結果を構造化 JSON で返却
  • -スキーマ:テーブル、カラム、インデックス、拡張機能の確認
  • -プレビュー:プレビュー用データベースの作成、一覧、リセット、削除
  • -バックアップ:バックアップ一覧、復元ポイント作成、プレビューを指定時点へ復元
  • -インポート:他事業者からのインポートの開始と追跡
  • -ワークスペース:組織、メンバー、API キー、使用量、監査エントリ

05

安全性

読み取り専用ツールは読み取り専用と、破壊的ツールは破壊的と自己申告するので、クライアント側で制御できます。破壊的 SQL は先に復元ポイントを必要とし、サーバーは文を実行するのではなくエージェントにそれを指示します。

本番データベースへの上書き復元は、意図的にツールとして公開していません。エージェントはプレビューへ復元でき、昇格は人の手で行います。エージェントの一存で本番データが上書きされることはありません。

06

診断

サーバーが自分について語ることはすべて標準エラー出力に出ます。標準出力はプロトコルの通り道だからです。クライアントのツール一覧が空なら、答えはほぼ常にサーバーではなくクライアントの MCP ログにあります。