mcp-steampipe

by b0ttle-neck
MIT License

蒸汽管道 MCP

这是一个简单的 Steampipe MCP 服务器。它充当 AI 模型和 Steampipe 工具之间的桥梁。

先决条件

  • 已安装 Python 3.10+。
  • 安装了 uv(我的最爱)和 mcp[cli]
  • 蒸汽管道已安装并运行。
  • Steampipe 插件已配置(例如,github)并带有必要的凭证(例如,~/.steampipe/config/github.spc 中的令牌)。
  • 任何支持 MCP 的 LLM 都可以。我这里用的是 Claude。
  • 安装了 Node.js 和 npx(MCP Inspector 需要并且可能运行某些 MCP 服务器)。

运行 MCP 拦截器

这是一个非常棒的工具,可以测试您的 MCP 服务器是否按预期运行

  • 运行拦截器npx -y @modelcontextprotocol/inspector uv --directory . run steampipe_mcp_server.py
  • 应打开一个带有 MCP Inspector 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 脚本。
tail -f ~/Library/Logs/Claude/mcp.log tail -f ~/Library/Logs/Claude/mcp-server-steampipe.log

安全风险Claude 在此 POC 中盲目执行您的 SQL 查询,因此有可能使用您配置的凭据通过 Steampipe 生成和执行任意 SQL 查询。

-
security - not tested
-
license - not tested
-
quality - not tested

这是为 Steampipe 编写的 MCP。此 Steampipe MCP 工具允许 Claude 使用自然语言请求直接与您的 Steampipe 安装进行交互。它通过 Steampipe CLI 执行提供的 SQL 查询,并将数据结果以 JSON 格式返回给 Claude。

  1. Pre-requisites
    1. Running MCP Interceptor
      1. Running the tool
        1. TroubleShooting

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            Connects Claude Desktop directly to databases, allowing it to explore database structures, write SQL queries, analyze datasets, and create reports through an API layer with tools for table exploration and query execution.
            Last updated -
            176
            Python
            Mozilla Public License 2.0
            • Apple
          • A
            security
            A
            license
            A
            quality
            An MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.
            Last updated -
            7
            18
            4
            TypeScript
            MIT License
            • Apple
            • Linux
          • -
            security
            F
            license
            -
            quality
            This is a Model Context Protocol (MCP) server for executing SQL queries against Databricks using the Statement Execution API. It enables AI assistants to directly query Databricks data warehouses, analyze database schemas, and retrieve query results in a structured format
            Last updated -
            4
            Python
            • Linux
            • Apple
          • -
            security
            F
            license
            -
            quality
            A natural language interface that allows Claude to execute SQL queries on your local MySQL databases, enabling database interaction using natural language.
            Last updated -
            2
            Python
            • Linux
            • Apple

          View all related MCP servers

          ID: 5jtgioloff