Skip to main content
Glama
mcp-steampipe

mcp-steampipe

by b0ttle-neck

スチームパイプMCP

これはシンプルなSteampipe MCPサーバーです。AIモデルとSteampipeツール間の橋渡しとして機能します。

前提条件

  • Python 3.10+ がインストールされています。

  • uv をインストールしました(私のお気に入り)そして mcp[cli]

  • Steampipe がインストールされ、動作しています。

  • 必要な資格情報 (例: ~/.steampipe/config/github.spc 内のトークン) を使用して構成された Steampipe プラグイン (例: github)。

  • MCPをサポートするLLMであればどれでも構いません。私はClaude Hereを使用しています。

  • Node.js と npx がインストールされています (MCP Inspector に必要であり、一部の MCP サーバーの実行にも必要になる可能性があります)。

Related MCP server: mcp-mssql-server

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からツールを選択します。 スクリーンショット 2025-04-06 11:53 23PMスクリーンショット 2025-04-06 11:55 21PM

トラブルシューティング

  • インターセプター内にツールが見つからない場合は、@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 クエリを生成および実行する可能性があります。

Available Tools

1 tool
run_steampipe_queryB

Executes a SQL query using the Steampipe CLI and returns the results as a JSON string.

Args: query: The SQL query to execute via Steampipe (e.g., "select login from github_user limit 1"). Ensure the query is valid Steampipe SQL.

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined and distinct by default.

    Naming Consistency5/5

    A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The naming follows a clear verb_noun pattern (run_steampipe_query).

    Tool Count2/5

    A single tool is too few for most practical purposes, as it severely limits the server's functionality and flexibility. While it might cover the basic query execution, it lacks any supporting operations like listing available tables, checking query status, or managing connections.

    Completeness2/5

    The server is severely incomplete for interacting with Steampipe. It only provides query execution, missing essential operations such as listing available plugins/tables, describing table schemas, managing connections, or handling query errors and metadata. This will cause significant agent failures in complex workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with SQLite databases, filesystem, AWS IAM, and Gmail through a master MCP server with a Streamlit UI optimized for Claude.
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude Code and other MCP clients to interact with Microsoft SQL Server databases through standardized tools for query execution, schema exploration, table management, and stored procedure execution.
      90 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude to query a Postgres analytics schema via a read-only MCP server, with tools auto-generated from live database introspection and configurable SQL queries defined in YAML.
      MIT