Tiger Data MCP Server

Tiger CLI

Tiger CLI は Tiger Cloud のコマンドラインインターフェースです。データベースサービスの管理とクエリを実行するコマンドに加え、AI アシスタントで使用できる Model Context Protocol（MCP）サーバーが統合されています。

インストール

複数のインストール方法が用意されています。以下からお好みの方法を選択してください。迷った場合は、最初の方法をお使いください。

インストールスクリプト（macOS/Linux/WSL）

curl -fsSL https://cli.tigerdata.com | sh

インストールスクリプト（Windows）

irm https://cli.tigerdata.com/install.ps1 | iex

Homebrew（macOS/Linux）

brew install --cask timescale/tap/tiger-cli

Debian/Ubuntu

# Add repository
curl -s https://packagecloud.io/install/repositories/timescale/tiger-cli/script.deb.sh | sudo os=any dist=any bash

# Install tiger-cli
sudo apt-get install tiger-cli

リポジトリを手動でインストールする方法については、こちらをご覧ください。

Red Hat/Fedora

# Add repository
curl -s https://packagecloud.io/install/repositories/timescale/tiger-cli/script.rpm.sh | sudo os=rpm_any dist=rpm_any bash

# Install tiger-cli
sudo yum install tiger-cli

リポジトリを手動でインストールする方法については、こちらをご覧ください。

Go インストール

go install github.com/timescale/tiger-cli/cmd/tiger@latest

アップデート

既存のインストールを最新リリースにアップグレードするには、次のコマンドを実行します。

tiger upgrade

最新の公開バイナリをダウンロードしてチェックサムを検証し、現在実行中のバイナリをその場で置き換えます。Tiger CLI がパッケージマネージャー（Homebrew、apt、yum/dnf）経由でインストールされている場合、tiger upgrade は代わりに、該当するパッケージマネージャーのコマンドを案内します。

クイックスタート

Tiger CLI をインストールしたら、Tiger Cloud アカウントで認証します。

# Login to your Tiger account
tiger auth login

# View available commands
tiger --help

# List your database services
tiger service list

# Create a new database service
tiger service create --name my-database

# Get connection string
tiger db uri

# Connect to your database
tiger db psql

# Run a query without psql
tiger db query -c "SELECT now()"

# Install the MCP server
tiger mcp install

# Install agent skills for your coding agent
tiger skills install

使用方法

Tiger CLI では、次のコマンドを使用できます。

• tiger auth - 認証管理
  • login - Tiger アカウントにログインします（--headless を使用すると、任意のマシンのブラウザーで短いコードを使って認証できます）
  • logout - Tiger アカウントからログアウトします
  • status - 現在の認証状態とプロジェクト ID を表示します（エイリアス：whoami）
• tiger project - プロジェクト管理
  • list - アクセス権のあるすべてのプロジェクトを一覧表示し、アクティブなプロジェクトに印を付けます（エイリアス：ls）
  • use - アクティブなプロジェクトを切り替えます（OAuth ログインが必要です。前のプロジェクトに属していたデフォルトの service_id はクリアされます）（エイリアス：switch）
• tiger service - サービスのライフサイクル管理（エイリアス：services、svc）
  • list - すべてのサービスを一覧表示します（エイリアス：ls）
  • create - 新しいサービスを作成します
  • get - サービスの詳細情報を表示します（エイリアス：describe、show）
  • fork - 既存のサービスをフォークします
  • start - 停止中のサービスを起動します（エイリアス：resume）
  • stop - 実行中のサービスを停止します（エイリアス：pause）
  • rename - サービスの名前を変更します
  • resize - サービスに割り当てる CPU とメモリの容量を変更します
  • delete - サービスを削除します（エイリアス：rm）
  • update-password - サービスのマスターパスワードを更新します
  • logs - サービスのログを表示します（エイリアス：log）
  • metrics available - サービスで利用できるメトリクス名を一覧表示します
  • metrics details - メトリクスの説明、種類、デフォルトの集計方法、ラベルを表示します
  • metrics series - ラベルフィルター、集計関数、グループ化、バケットサイズを指定して、メトリクスの時系列データを取得します
• tiger db - データベース操作
  • psql - psql でデータベースに接続します（対話型ターミナルで、サービスに読み取りレプリカがある場合は、いずれかへの接続を選択できます。スキップするには --no-replica-prompt を使用します）（エイリアス：connect）
  • query - psql を使わずにデータベースに対して SQL クエリを実行し、結果を表示します（エイリアス：sql）
  • uri - サービスの接続 URI を取得します（エイリアス：connection-string）
  • ping - データベースへの接続をテストします（エイリアス：test、test-connection）
  • schema - データベースのスキーマ情報（テーブル、ビュー、インデックス、関数、TimescaleDB のハイパーテーブルなど）を表示します
  • extensions list - データベースにインストールされている PostgreSQL 拡張機能を、バージョンとスキーマとともに一覧表示します（エイリアス：ext ls）
  • save-password - データベースのパスワードを、設定済みのパスワードストレージ（キーリング、pgpass、またはなし）に保存します
  • create role - 読み取り専用の適用、権限の継承（--from）、ステートメントタイムアウトを任意で指定して、新しいデータベースロールを作成します（エイリアス：create user）
• tiger config - 設定管理（エイリアス：cfg）
  • list - 現在の設定を一覧表示します（エイリアス：ls、show）
  • set - 設定値を設定します
  • unset - 設定値を削除します（エイリアス：rm、delete）
  • reset - 設定をデフォルトにリセットします（エイリアス：clear）
• tiger mcp - MCP サーバーのセットアップと管理
  • install - AI アシスタント用の MCP サーバーをインストールして設定します（エイリアス：add）
  • start - MCP サーバーを起動します
  • list - 利用可能な MCP ツール、プロンプト、リソースを一覧表示します（エイリアス：ls）
  • get - 特定の MCP 機能の詳細情報を取得します（エイリアス：describe、show）
• tiger skills - AI コーディングエージェント向けのエージェントスキル
  • install - AI コーディングエージェント向けに PostgreSQL および TimescaleDB のスキルをインストールします（エイリアス：add）
• tiger feedback - Tiger Data チームにフィードバックまたはバグ報告を送信します（メッセージは引数または標準入力で渡します）
• tiger version - バージョン情報を表示します
• tiger upgrade - Tiger CLI を最新バージョンにアップグレードします（エイリアス：update）

各コマンドの詳細については tiger <command> --help を使用するか、生成された CLI リファレンスを参照してください。

サービスの指定

コマンドの引数にサービスを指定する場合は、サービスの ID（または読み取りレプリカセットの ID）か名前を指定します。

tiger db psql my-api-db
tiger service stop my-api-db

名前は完全一致で照合されます。複数のサービスに一致する名前を指定すると拒否されます。目的の ID を見つけるには、tiger service list を実行してください。デフォルトのサービス（tiger config set service_id、--service-id、または TIGER_SERVICE_ID）には ID を指定する必要があり、破壊的なコマンドでは確認のため、引き続き ID の入力が求められます。MCP ツールで指定できるのは ID のみです。

MCP サーバー

Tiger CLI には Model Context Protocol（MCP）サーバーが含まれており、Claude Code などの AI アシスタントが Tiger Cloud インフラストラクチャを操作できるようになります。MCP サーバーを通じて、データベースサービスや操作にプログラムからアクセスできます。

インストール

AI アシスタント用に MCP サーバーを設定します。

# Interactive installation (prompts for client selection)
tiger mcp install

# Or specify your client directly
tiger mcp install claude-code      # Claude Code
tiger mcp install codex            # Codex
tiger mcp install copilot          # GitHub Copilot CLI
tiger mcp install cursor           # Cursor IDE
tiger mcp install devin            # Devin
tiger mcp install gemini           # Gemini CLI
tiger mcp install vscode           # VS Code

インストール後、AI アシスタントを再起動して Tiger MCP サーバーを有効にします。

手動インストール

お使いの MCP クライアントが tiger mcp install でサポートされていない場合は、MCP サーバーのインストール手順に従ってください。MCP サーバーの起動コマンドには tiger mcp start を使用します。たとえば、多くのクライアントでは次のような JSON ファイルを使用します。

{
  "mcpServers": {
    "tiger": {
      "command": "tiger",
      "args": [
        "mcp",
        "start"
      ]
    }
  }
}

Streamable HTTP プロトコル

上記の手順では、stdio トランスポートを使用して MCP サーバーをインストールします。代わりに Streamable HTTP トランスポートを使用する場合は、tiger mcp start http --port 8080 でサーバーを起動し、URL として http://localhost:8080 を指定してクライアントにインストールできます。

利用可能な MCP ツール

MCP サーバーは、AI アシスタントに次のツールを提供します。

サービス管理：

• service_list - プロジェクト内のすべてのデータベースサービスを一覧表示します
• service_get - 特定のサービスの詳細情報を取得します
• service_create - リソースを設定して新しいデータベースサービスを作成します
• service_fork - 既存のデータベースサービスをフォークして、独立したコピーを作成します
• service_start - 停止中のデータベースサービスを起動します
• service_stop - 実行中のデータベースサービスを停止します
• service_rename - データベースサービスの名前を変更します
• service_resize - CPU とメモリの割り当てを変更して、データベースサービスのサイズを変更します
• service_delete - データベースサービスを完全に削除します（サービスに PROD タグが付いている場合は、事前に確認を求めます）
• service_update_password - サービスの新しいランダム生成マスターパスワードを設定します（サービスに PROD タグが付いている場合は、事前に確認を求めます）
• service_logs - データベースサービスのログを表示します

サービスのメトリクス：

• service_metrics_available - サービスで利用可能なメトリクス名を一覧表示します（ハードウェア使用状況、PostgreSQL の設定とアクティビティ、PgBouncer のプール、TimescaleDB の内部情報）
• service_metrics_details - メトリクスの説明、種類、デフォルトの集計方法、ラベルを表示します
• service_metrics_series - ラベルフィルター、集計関数、グループ化、バケットサイズを指定して、時間範囲内のメトリクスの時系列データを取得します

データベース操作：

• db_query - データベースサービスに対して SQL クエリを実行します。クエリは直接指定するか SQL ファイルのパスで指定でき、パラメーター化クエリ、カスタムタイムアウト、コネクションプーリングに対応しています
• db_schema - サービスのデータベーススキーマ（テーブル、ビュー、マテリアライズドビュー、列挙型、関数、プロシージャ、インデックス、トリガー、TimescaleDB のハイパーテーブル／連続集約のメタデータ）を、エージェントのコンテキストとして読みやすいテキストで表示します
• db_extensions_list - サービスのデータベースにインストールされている PostgreSQL 拡張機能を、それぞれのバージョン、スキーマ、説明とともに一覧表示します

フィードバック：

• feedback - Tiger Data チームにフィードバックまたはバグレポートを送信します

MCP サーバーは CLI の認証情報と設定を自動的に使用するため、tiger auth login 以外の追加設定は必要ありません。

プロキシ経由のツール

上記のサービス管理ツールに加えて、Tiger MCP サーバーはリモートドキュメント MCP サーバーのツールもプロキシします。この機能により、AI アシスタントは PostgreSQL、TimescaleDB、Tiger Cloud のドキュメントをセマンティック検索できるほか、さまざまな Tiger Cloud 機能のプロンプトやガイドを利用できます。

プロキシされるドキュメントサーバー（pg-aiguide）は、現在以下のツールを提供しています。

• view_skill - Postgres と TimescaleDB の機能およびベストプラクティスに関する包括的なガイドを取得します
• search_docs - 自然言語のクエリを使用して PostgreSQL と TimescaleDB のドキュメントを検索します

このプロキシ接続はデフォルトで有効になっており、追加の設定は必要ありません。

ドキュメントプロキシを無効にするには、次のようにします。

tiger config set docs_mcp false

エージェントスキル

Tiger CLI は、厳選された PostgreSQL と TimescaleDB のスキルをコーディングエージェントに直接インストールできます。

# Interactive installation (prompts for install locations)
tiger skills install

# Or name the locations directly
tiger skills install universal claude-code

スキルは現在のユーザー向けにインストールされます。universal の場所である ~/.agents/skills は、ほとんどのコーディングエージェント（Cursor、Codex、Gemini CLI、 VS Code、GitHub Copilot CLI、Devin）から読み込まれます。Claude Code、Kiro CLI、Google Antigravity はそれぞれ独自のスキルディレクトリを読み込むため、別の場所 （claude-code、kiro-cli、antigravity）になります。cursor のように ~/.agents/skills を読み込むクライアントを指定すると、universal が選択されます。--skills-dir を使用すると、任意のディレクトリにインストールできます。

コマンドを再実行すると、スキルが最新バージョンに更新され、利用できなくなったスキルは削除されます。引数を指定しない場合は、以前にインストールした場所がピッカーで最初から選択されます。既存のスキルが Tiger CLI によってインストールされたものでない場合、--force を指定しない限り置き換えられることはありません。

設定

CLI はデフォルトで設定を ~/.config/tiger/config.yaml に保存し、環境変数とコマンドラインフラグによる階層的な設定をサポートしています。

# List current configuration
tiger config list

# Set configuration values
tiger config set output json

# Remove configuration value
tiger config unset output

# Reset to defaults
tiger config reset

設定オプション

すべての設定オプションは、tiger config set <key> <value> で設定できます。

• analytics - アナリティクスを有効または無効にします（デフォルト：true）

• color - 色付きの出力を有効または無効にします（デフォルト：true）

• docs_mcp - ドキュメント MCP プロキシを有効または無効にします（デフォルト：true）

• mcp_max_rows - AI エージェントのコンテキストに取り込まれるデータ量を制限するため、切り詰める前に db_query MCP ツールが結果セットごとに返す最大行数です。MCP ツールにのみ適用され、CLI コマンドには適用されません。デフォルト：100

• output - 出力形式：json、yaml、または table（デフォルト：table）

• password_storage - パスワードの保存方法：keyring、pgpass、または none（デフォルト：keyring）

• read_only - この CLI が変更できるサービスを指定します：all、prod、または off（デフォルト：off。何も保護しません）。対話型の tiger auth login では、3 つのモードから選ぶメニューが表示され、選択した内容はどの場合も記録されるため、一度回答すれば以降は尋ねられません。true と on は all のエイリアスとして、false は off のエイリアスとして受け付けられるため、既存の設定ファイルや TIGER_READ_ONLY=true はこれまでどおり動作します。

  保護されたサービスの変更は拒否され、サービスの作成も拒否されます。tiger service create/fork/start/stop/rename/resize/update-password/delete と tiger db create role はエラーを返します。そのサービスの接続文字列を使うと、Tiger Cloud の変更不可な読み取り専用モードでセッションが開始されるため、サーバーが書き込みと DDL を拒否します。これは tiger db psql、tiger db query、tiger db uri、db_query MCP ツール、および tiger service の出力に含まれる接続文字列と、同等の MCP ツールに適用されます。

  • all はすべてのサービスを保護し、MCP の書き込みツールは登録されないため、tools/list に表示されず、呼び出すこともできません。
  • prod は PROD タグが付いたサービスのみを保護し、DEV サービスは書き込み可能なままにします。tiger service create/fork と service_create/service_fork MCP ツールは、要求された環境に基づいて制御されるため、DEV サービスの作成は許可されますが、PROD サービスの作成は許可されません。そうしないと、このモードで削除が拒否されるサービスを作成できてしまいます。PROD サービスを DEV のフォークにフォークすることは、変更を加えずに本番環境を読み取るだけなので許可されます。MCP の書き込みツールは登録されたままで、DEV サービスでは引き続き動作し、呼び出しごとに操作を拒否します。これらのコマンドは、解決したサービスからタグを読み取るため、タグの取得に追加の API 呼び出しは必要ありません。検索に失敗した場合は操作が拒否されます。ID を受け取る MCP の書き込みツールは、サービスを取得してタグを読み取ります。読み取りレプリカは自身のタグに基づいて判定されるため、PROD のプライマリのレプリカでも、そのレプリカセット自体に PROD のタグが付いている場合にのみ保護されます。

• service_id - デフォルトのサービス ID。アクティブなプロジェクトが変わると自動的にクリアされます。これは tiger project の実行時、および tiger auth login のログイン先が前回のログインと同じプロジェクトでない場合に発生します。サービスは作成されたプロジェクトに属します

• version_check - true の場合、CLI は呼び出しごとに（対話型ターミナルで）新しいバージョンがあるか確認し、利用可能な場合は通知を表示します。無効にするには false に設定します。デフォルト：true

環境変数

環境変数は設定ファイルの値より優先されます。すべての変数には TIGER_ プレフィックスが付きます。

• TIGER_ANALYTICS - アナリティクスを有効または無効にします
• TIGER_COLOR - 色付き出力を有効または無効にします
• TIGER_CONFIG_DIR - 設定ディレクトリへのパス（デフォルト：~/.config/tiger）
• TIGER_DOCS_MCP - docs MCP プロキシを有効または無効にします
• TIGER_OUTPUT - 出力形式：json、yaml、または table
• TIGER_PASSWORD_STORAGE - パスワードの保存方法：keyring、pgpass、または none
• TIGER_READ_ONLY - この CLI が変更できるサービス：all、prod、または off（read_only と同じ別名）
• TIGER_PUBLIC_KEY - 認証に使用する公開鍵（保存済みの認証情報より優先されます）
• TIGER_SECRET_KEY - 認証に使用するシークレットキー（保存済みの認証情報より優先されます）
• TIGER_SERVICE_ID - デフォルトのサービス ID（名前は受け付けられません。サービスの命名を参照）
• TIGER_VERSION_CHECK - true の場合、CLI は起動のたびに（対話型ターミナルで）新しいバージョンがないか確認し、利用可能な場合は通知を表示します。無効にするには false を指定します

グローバルフラグ

これらのフラグはすべてのコマンドで使用でき、環境変数と設定ファイルの値の両方より優先されます。

• --analytics - アナリティクスを有効または無効にします
• --color - 色付き出力を有効または無効にします
• --config-dir <path> - 設定ディレクトリへのパス（デフォルト：~/.config/tiger）
• --password-storage <method> - パスワードの保存方法：keyring、pgpass、または none
• --service-id <id> - サービス ID（名前は受け付けられません。代わりに引数として指定してください）
• --version-check - 起動時の更新確認を有効または無効にします
• -h, --help - ヘルプ情報を表示します

コントリビュート

コントリビュートを歓迎します。開始するには、次の手順に従ってください。

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. 新機能のテストを追加します
5. すべてのテストが通ることを確認します（go test ./...）
6. プルリクエストを送信します

開発に関する詳しい情報は、docs/development.mdを参照してください。

ライセンス

このプロジェクトは Apache License 2.0 のライセンスに基づいています。詳細については LICENSE ファイルを参照してください。