Steampipe

🚀 Steampipe MCP 服務器

這是一個簡單的 Steampipe MCP 服務器，它在您的 AI 模型和 Steampipe 工具之間搭建了一座橋樑，讓二者能夠順暢交互。

🚀 快速開始

✨ 主要特性

此服務器作為 AI 模型與 Steampipe 工具的橋樑，實現兩者之間的有效連接與交互。

📦 安裝指南

在運行 Steampipe MCP 服務器之前，您需要完成以下先決條件的設置：

• 安裝 Python 3.10 或更高版本。
• 安裝 uv（我的最愛）和 mcp[cli]。
• 安裝並配置好 Steampipe 並使其正常運行。
• 配置 Steampipe 插件（例如 github 插件），並準備好相關憑據（例如將令牌放在 ~/.steampipe/config/github.spc 中）。
• 使用支持 MCP 的任何 LLM，這裡使用的是 Claude。
• 安裝 Node.js 和 npx（用於運行 MCP 檢查器和可能的某些 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 查詢生成和執行的可能。請謹慎使用。