Steampipe MCP服务器

一个连接AI模型和Steampipe工具的MCP服务器,用于执行Steampipe查询。

  • by b0ttle-neck
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 b0ttle-neck/mcp-steampipe

使用说明

蒸汽管MCP

这是一个简单的蒸汽管道MCP服务器。这可以作为您的AI模型和Steampipe工具之间的桥梁。

先决条件

  • 已安装Python 3.10+。
  • 安装了uv(我的fav)和mcp[cli]
  • 蒸汽管已安装并正常工作。
  • 使用必要的凭据(例如~/.streampipe/config/github.spc中的令牌)配置Steampipe插件(例如github)。
  • 任何支持MCP的LLM。我在这里用克劳德。
  • 安装了Node.js和npx(MCP检查器需要,可能运行一些MCP服务器也需要)。

正在运行MCP侦听器

这是一个非常棒的工具,用于测试您的MCP服务器是否按预期工作

  • 运行拦截器 npx -y @modelcontextprotocol/inspector uv --directory . run steampipe_mcp_server.py
  • 浏览器窗口应打开MCP Inspector UI(通常在http://localhost:XXXX).
  • 等待左侧面板上的“已连接”状态。
  • 转到“工具”选项卡。
  • 您应该看到run_streampipe_query工具及其描述。
  • 单击工具名称。
  • 在“Arguments”JSON输入字段中,输入有效的Steampipe查询:
{
  "query": "select name, fork_count from github_my_repository "
}
  • 执行并查看json结果

运行工具

相当直接。只需运行拦截器,并确保该工具在目录中工作。然后将服务器配置添加到相应的LLM中,并从LLM中选择工具。

故障排除

  • 如果在拦截器中找不到该工具,则意味着@mcp.tool()装饰器有问题。
  • 执行错误-查看检查器中的“结果”和终端中的服务器日志(stderr)。蒸汽管跑了吗?是否存在SQL错误?暂停?JSON解析错误?相应地调整Python脚本。
tail -f ~/Library/Logs/Claude/mcp.log
tail -f ~/Library/Logs/Claude/mcp-server-steampipe.log

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