Steampipe

🚀 Steampipe MCP サーバー

この Steampipe MCP サーバーは、AI モデルと Steampipe ツールの間の橋渡しを行います。シンプルな構成で、両者の連携を容易にします。

🚀 クイックスタート

✨ 主な機能

• AI モデルと Steampipe ツールの橋渡しを行います。
• MCP チェッカーを使用してサーバーの動作確認ができます。
• サポートされている LLM からツールを選択して使用できます。

📦 インストール

前提条件

• Python 3.10 以上をインストールしてください。
• uv（オススメ）と mcp[cli]をインストールしてください。
• Steampipe をインストールし、正常に動作するように設定してください。
• Steampipe プラグイン（例：github プラグイン）を設定し、関連する認証情報（例：トークンを ~/.steampipe/config/github.spc に配置）を準備してください。
• MCP をサポートする任意の LLM を使用します。ここでは Claude を使用しています。
• Node.js と npx をインストールしてください（MCP チェッカーや一部の MCP サーバーを実行するため）。

💻 使用例

基本的な使用法

MCP チェッカーの実行

このツールは、MCP サーバーが正常に動作しているかをテストするのに便利です。 npx -y @modelcontextprotocol/inspector uv --directory . run steampipe_mcp_server.py

• ブラウザウィンドウが MCP チェッカー UI を開きます（通常は http://localhost:XXXX）。
• 左側のパネルが「接続済み」の状態になるまで待ちます。
• ツールタブに移動します。
• ツールリストに run_steampipe_query ツールとその説明が表示されるはずです。
• ツール名をクリックします。
• 「パラメータ」JSON 入力フィールドに有効な Steampipe クエリを入力します。

{
  "query": "select name, fork_count from github_my_repository"
}

• 実行し、JSON 結果を確認します。

高度な使用法

ツールの実行

非常に簡単です。チェッカーを実行してツールが正常に動作することを確認してから、サーバー設定を対応する LLM に追加し、LLM からツールを選択します。

🔧 技術詳細

トラブルシューティング

• チェッカーでツールが見つからない場合は、@mcp.tool() デコレータに問題がある可能性があります。
• 実行エラーの場合は、チェッカーの「結果」とサーバーログ（stderr）を確認してください。Steampipe が正常に動作しているか、SQL エラー、タイムアウト、JSON 解析エラーがないかを確認し、Python スクリプトを調整してください。

セキュリティリスク

Claude は SQL クエリを無条件に実行するため、この POC では任意の SQL クエリの生成と実行が可能です。注意して使用してください。