Infra MCP

 agent ──stdio──▶ infra-mcp ──SSH──▶  VMs  (journald · log files)
                                  └──▶  DBs  (read-only PostgreSQL)

エージェントは、ターミナルにアクセスすることなく、サービスの稼働状況の確認、範囲を限定したログの取得、DB の状態の調査、テーブルスキーマの確認を行えます。すべてのリモート操作は許可リストで制限され、追記専用の監査ログに記録されます。

インストール

uv tool install infra-mcp
# or
pip install infra-mcp

設定

infra-mcp.yaml.example を ~/.infra-mcp/infra-mcp.yaml にコピーして編集します。

# Generate a starter config from ~/.ssh/config
infra-mcp generate-config -o ~/.infra-mcp/infra-mcp.yaml

# Create the read-only PostgreSQL role(s)
infra-mcp setup

# Check VM reachability
infra-mcp test

# Refresh discovered services, log dirs, and databases (updates config in place)
infra-mcp discover --in-place

--config または INFRA_MCP_CONFIG で設定ファイルのパスを指定できます。

実行

infra-mcp run

クライアント（Claude Code、Cursor など）で、コマンド infra-mcp run を使用する stdio MCP サーバーとして登録します。

更新

infra-mcp は 1 日に 1 回 PyPI を確認し、新しいリリースがある場合は、アップグレード方法を知らせる 1 行のヒントを stderr に出力します。

uv tool upgrade infra-mcp   # or: pip install --upgrade infra-mcp

確認はバックグラウンドで実行され、起動を妨げることも、stdout に触れることもありません。infra-mcp --version でインストール済みのバージョンを表示できます。INFRA_MCP_NO_UPDATE_CHECK=1 を設定すると、確認を完全に無効にできます。

ツール

VM とサービス

データベース

メタ

すべての出力はサーバー側で上限が設定されています（ログ行 200 行、DB 行 100 行、テーブル／列は最大 200 件）。切り詰めが発生した場合は必ず -- TRUNCATED: マーカーで示されます。list_tables と describe_table は結果をメモリにキャッシュします（TTL：schema_cache_ttl_hours、既定値は 24 時間）。最新の情報を再取得するには refresh: true を指定してください。

セキュリティモデル

• SSH コマンドと systemd サービスは、ネットワーク呼び出しを行う前に、VM ごとの許可リストと照合されます。
• すべてのデータベースクエリは、READ ONLY トランザクション内で読み取り専用ロールとして実行されます。
• ログファイルのパスは、VM ごとのディレクトリ許可リストに照らして解決されます（.. によるディレクトリ遡りは禁止されています）。
• すべてのリモート操作は、ローカルの JSONL 監査ログに追記されます。