Tailpipe Model Context Protocol (MCP) Server

Tailpipe Model Context Protocol（MCP）サーバー

Tailpipeで、AI を活用したログ分析の力を引き出しましょう！この Model Context Protocol サーバーは、Claude などの AI アシスタントをクラウドや SaaS のログにシームレスに接続し、データ資産全体を自然言語で探索・分析できるようにします。

Tailpipe MCP は AI アシスタントとログデータをつなぎ、自然言語で次のことを行えるようにします。

• CloudTrail、Kubernetes、その他のクラウドサービスのログを横断したクエリ
• セキュリティインシデントの調査と分析
• コストとパフォーマンスに関するインサイト
• クエリの作成支援

ローカルの Tailpipe init SQL スクリプトと連携し、クラウドや SaaS のログデータ全体に対して安全な読み取り専用アクセスを提供します。

インストール

前提条件

• Node.js v16 以降（npxを含む）
• Tailpipe のインストールと設定

設定

AI アシスタントの設定ファイルに Tailpipe MCP を追加します。

{
  "mcpServers": {
    "tailpipe": {
      "command": "npx",
      "args": [
        "-y",
        "@turbot/tailpipe-mcp"
      ]
    }
  }
}

デフォルトでは、Tailpipe CLI を使用して init SQL スクリプトを検出します。まず Tailpipe がインストールされ、設定されていることを確認してください。

特定の init SQL スクリプトに接続するには、args にパスを追加します。

{
  "mcpServers": {
    "tailpipe": {
      "command": "npx",
      "args": [
        "-y",
        "@turbot/tailpipe-mcp",
        "/path/to/your/tailpipe_init_YYYYMMDDHHMMSS.sql"
      ]
    }
  }
}

AI アシスタントの設定

アシスタント	設定ファイルの場所	設定ガイド
Claude Desktop	claude_desktop_config.json	Claude Desktop MCP ガイド →
Cursor	~/.cursor/mcp.json	Cursor MCP ガイド →

設定ファイルを保存し、変更を反映するために AI アシスタントを再起動します。

プロンプトガイド

ログデータについて何でも質問してください！

ログデータを探索します。

What tables do we have available in Tailpipe?

シンプルで具体的な質問が効果的です。

Show me all S3 bucket creation events from CloudTrail in the last 24 hours

セキュリティレポートを生成します。

What were my top 10 AWS services by cost last month?

インシデント分析を掘り下げます。

Find any IAM users created outside working hours (9am-5pm) in the last week

タイムラインに関するインサイトを得ます。

Give me a timeline of the session where Venu created the IAM access key

潜在的なリスクを調べます。

Analyze our cloudtrail errors for any specific security risks

次の点に注意してください。

• 調べたい期間を具体的に指定します
• 分析したいデータの種類（CloudTrail イベント、コストデータなど）を伝えます
• 複雑な条件を加える前に、シンプルなクエリから始めます
• 自然言語を使います。LLM が SQL への変換を処理します
• 大胆に、いろいろと試してみましょう。LLM が発見し、実現できることは驚くほどたくさんあります！

機能

ツール

データベース操作：

• tailpipe_query

  • DuckDB 構文を使用して、読み取り専用の Tailpipe SQL クエリを実行します
  • 入力：sql（string）：実行する SQL クエリ

• tailpipe_connect

  • Tailpipe init SQL スクリプトから DuckDB セッションを初期化または更新します
  • 任意の入力：init_script_path（string）：使用する init SQL スクリプトのパス。指定しない場合は、現在の接続を更新します。

データ構造操作：

• tailpipe_partition_list

  • 利用可能なすべての Tailpipe パーティションを簡単な統計情報とともに一覧表示します
  • 入力パラメーターは不要です

• tailpipe_partition_show

  • 指定した Tailpipe パーティションの詳細を表示します
  • 入力：name（string）：詳細を表示するパーティションの名前

• tailpipe_table_list

  • 利用可能なすべての Tailpipe テーブルを一覧表示します
  • 入力パラメーターは不要です

• tailpipe_table_show

  • 指定した Tailpipe テーブルとその列の詳細を表示します
  • 入力：name（string）：詳細を表示するテーブルの名前

プラグイン操作：

• tailpipe_plugin_list

  • システムにインストールされているすべての Tailpipe プラグインを一覧表示します
  • 入力パラメーターは不要です

• tailpipe_plugin_show

  • 指定した Tailpipe プラグインのインストール情報を取得します
  • 入力：name（string）：詳細を表示するプラグインの名前

ソース操作：

• tailpipe_source_list

  • システムで利用可能なすべての Tailpipe ソースを一覧表示します
  • 入力パラメーターは不要です

• tailpipe_source_show

  • 指定した Tailpipe ソースの詳細を取得します
  • 入力：name（string）：詳細を表示するソースの名前

リソース

• status
  • Tailpipe 接続の現在の状態を表します
  • プロパティには以下が含まれます：
    • 使用中の初期化スクリプトのパス
    • サーバー設定
    • ランタイム環境

このリソースを使用すると、AI ツールで Tailpipe セッションへの接続状態を確認、検証できます。

開発

クローンとセットアップ

1. リポジトリをクローンし、ディレクトリに移動します：

git clone https://github.com/turbot/tailpipe-mcp.git
cd tailpipe-mcp

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

テスト

ローカルの開発ビルドを MCP に対応した AI ツールでテストするには、MCP 設定を更新し、npm パッケージの代わりにローカルの dist/index.js を使用します。例：

{
  "mcpServers": {
    "tailpipe": {
      "command": "node",
      "args": [
        "/absolute/path/to/tailpipe-mcp/dist/index.js",
        "/path/to/your/tailpipe_init_YYYYMMDDHHMMSS.sql"
      ]
    }
  }
}

または、MCP Inspector を使用してサーバーの実装を検証します：

npx @modelcontextprotocol/inspector dist/index.js

環境変数

MCP サーバーの設定には、以下の環境変数を使用できます：

• TAILPIPE_MCP_INIT_SCRIPT_PATH：Tailpipe の初期化 SQL スクリプトのパスを指定します（コマンドライン引数の代替）
• TAILPIPE_MCP_LOG_LEVEL：ログの詳細度を制御します（デフォルト：info）
  • debug：すべてのメッセージを表示します（最も詳細）
  • info：情報、警告、エラーメッセージを表示します
  • warn：警告とエラーメッセージのみを表示します
  • error：エラーメッセージのみを表示します
• TAILPIPE_MCP_MEMORY_MAX_MB：コマンド実行時のメモリバッファーの最大サイズ（メガバイト）

オープンソースとコントリビューション

このリポジトリは、Apache 2.0 ライセンスのもとで公開されています。行動規範をご確認ください。皆さまと協力できることを楽しみにしています！

Tailpipe は、このオープンソースソフトウェアから Turbot HQ, Inc のみが開発した製品です。商用条件に基づいて配布されています。他者が独自にソフトウェアを配布することは認められていますが、Turbot の商標やクラウドサービスなどを使用することはできません。詳しくはオープンソースに関する FAQをご覧ください。

参加する

Slack で #tailpipe に参加 →

協力したいけれど、何から始めればよいかわからない場合は、help wanted ラベルの付いた課題に取り組んでみてください：

• Tailpipe
• Tailpipe MCP