infra-lens-mcp

infra-lens-mcp

Explain Linux incidents over SSH with baseline-aware MCP tooling.

infra-lens-mcp is a TypeScript MCP server that connects to Linux hosts over SSH, captures live metrics, stores local SQLite history, compares snapshots to baselines, and returns plain-English infrastructure explanations.

Demo

See the MCP 2025-11-25 compliance matrix for the current protocol support, delegated behavior, and open follow-up issues.

Tools

Tool	Purpose
analyze_server	Analyze a sampled snapshot against approved baselines, then store it as an observation
snapshot	Store a point-in-time observation without anomaly analysis
record_baseline	Save a labeled healthy-state sample
compare_to_baseline	Compare current state with a named baseline
get_history	Return CPU, memory, or load history from SQLite
inspect_host_capabilities	Check required Linux commands and proc files before collection

All tools return both readable JSON text and MCP structuredContent validated by declared outputSchema definitions, so clients and agents can consume responses without parsing the text block. Collection tools include a warnings array when optional sections cannot be collected but a partial snapshot is still usable.

Requirements

• Node.js 24 LTS for CI, Docker, and release workflows
• Node.js 22 or newer for package runtime compatibility
• pnpm 11.15.1 through Corepack for development installs
• Linux SSH targets with /proc, free, df, ps, and uname
• Strict SSH host verification through known_hosts or pinned SHA256 host keys

Quick Start

Run the stdio MCP server from npm:

npx -y infra-lens-mcp

Desktop MCP client style configuration:

{
  "mcpServers": {
    "infra-lens": {
      "command": "npx",
      "args": ["-y", "infra-lens-mcp"],
      "env": {
        "INFRA_LENS_DB": "/Users/you/.infra-lens-mcp/metrics.db"
      }
    }
  }
}

Local development:

corepack enable
corepack prepare [email protected] --activate
pnpm install --frozen-lockfile
pnpm run build
node dist/mcp.js

Configuration

Transport is selected by the executable entry point, not by an environment variable: npx -y infra-lens-mcp or node dist/mcp.js starts stdio, while node dist/server-http.js starts Streamable HTTP.