SPX MCP Server

Reiner Web-MCP-Server für php-spx-Berichte. Er ruft die eingebetteten SPX-Web-Endpunkte auf, analysiert den vollständigen Bericht und gibt LLM-große JSON-Zusammenfassungen anstelle von rohen Ereignisströmen zurück.

Voraussetzungen

• Node.js 20 oder neuer

• Eine Anwendung mit der spx-PHP-Erweiterung, die für HTTP-Profiling aktiviert ist

• SPX-HTTP-Zugriff konfiguriert, zum Beispiel:

spx.http_enabled=1
spx.http_key="dev"
spx.http_ip_whitelist="127.0.0.1"

Related MCP server: otel-mcp

Erstellen

npm install
npm run build

Der erstellte stdio-Einstiegspunkt ist:

/path/to/spx-mcp-server/dist/index.js

Setzen Sie diese Umgebungsvariablen in Ihrer Agentenkonfiguration oder übergeben Sie sie pro Tool-Aufruf:

SPX_BASE_URL=http://localhost
SPX_KEY=dev

Installation in Codex CLI

Bearbeiten Sie ~/.codex/config.toml und fügen Sie hinzu:

[mcp_servers.spx]
command = "node"
args = ["/path/to/spx-mcp-server/dist/index.js"]
env = { SPX_BASE_URL = "http://localhost", SPX_KEY = "dev" }

Starten Sie Codex CLI nach dem Bearbeiten der Datei neu.

Installation in Claude Code

Lokale Projektkonfiguration:

claude mcp add --transport stdio --scope project \
  --env SPX_BASE_URL=http://localhost \
  --env SPX_KEY=dev \
  spx -- node /path/to/spx-mcp-server/dist/index.js

Benutzerweite Konfiguration:

claude mcp add --transport stdio --scope user \
  --env SPX_BASE_URL=http://localhost \
  --env SPX_KEY=dev \
  spx -- node /path/to/spx-mcp-server/dist/index.js

Überprüfen:

claude mcp list
claude mcp get spx

Äquivalente .mcp.json-Projektkonfiguration:

{
  "mcpServers": {
    "spx": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/spx-mcp-server/dist/index.js"],
      "env": {
        "SPX_BASE_URL": "http://localhost",
        "SPX_KEY": "dev"
      }
    }
  }
}

Installation in Cline

Cline ist ein beliebter Open-Source-VS-Code-Agent mit MCP-Unterstützung.

Führen Sie für die Cline CLI aus:

cline mcp

Fügen Sie dann einen lokalen stdio-Server hinzu mit:

name: spx
command: node
args: /path/to/spx-mcp-server/dist/index.js
env:
  SPX_BASE_URL=http://localhost
  SPX_KEY=dev

Öffnen Sie für die VS Code-Erweiterung die Cline MCP Servers-Einstellungen und fügen Sie dieses JSON hinzu:

{
  "mcpServers": {
    "spx": {
      "command": "node",
      "args": ["/path/to/spx-mcp-server/dist/index.js"],
      "env": {
        "SPX_BASE_URL": "http://localhost",
        "SPX_KEY": "dev"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Installation in OpenClaw

OpenClaw ist ein Open-Source-Personal-Agent/Gateway, das ausgehende MCP-Server unter mcp.servers verwalten kann.

Bearbeiten Sie ~/.openclaw/openclaw.json oder die Datei, auf die OPENCLAW_CONFIG_PATH verweist:

{
  mcp: {
    servers: {
      spx: {
        command: "node",
        args: ["/path/to/spx-mcp-server/dist/index.js"],
        env: {
          SPX_BASE_URL: "http://localhost",
          SPX_KEY: "dev",
        },
      },
    },
  },
}

Überprüfen Sie die gespeicherte Konfiguration:

openclaw mcp status --verbose
openclaw mcp probe spx

Grundlegender Arbeitsablauf

1. Rufen Sie profile_url für die Web-URL auf, die Sie profilieren möchten.

2. Rufen Sie list_reports auf.

3. Wählen Sie den neuesten passenden Bericht aus.

4. Rufen Sie analyze_report oder get_hot_paths auf.

Werkzeuge

• profile_url: sendet eine HTTP-Anfrage mit aktivierten SPX-Cookies.

• list_reports: liest ?SPX_UI_URI=/data/reports/metadata.

• get_report_metadata: liest ein Berichts-Metadaten-JSON.

• analyze_report: lädt ?SPX_UI_URI=/data/reports/get/<key> herunter und analysiert es.

• get_hot_paths: gibt die teuersten Aufrufpfade zurück.

• get_function_profile: gibt die aggregierten Daten einer Funktion sowie Aufrufer/Aufgerufene zurück.

• get_raw_events: gibt einen paginierten Debug-Ausschnitt roher Ereignisse zurück.

Der Analysator begrenzt die Ausgabe standardmäßig. Große SPX-Berichte können Millionen von Ereignissen enthalten, daher wird die vollständige Rohberichtausgabe absichtlich nicht als normales Tool-Ergebnis bereitgestellt. get_raw_events ist auf 1000 Ereignisse pro Aufruf begrenzt und dient zum Debuggen des Parser- oder Analysatorverhaltens.

Referenzen

• Claude Code MCP-Konfiguration: https://code.claude.com/docs/en/mcp

• Cline MCP-Konfiguration: https://github.com/cline/cline/blob/main/docs/mcp/mcp-overview.mdx

• OpenClaw MCP-Konfiguration: https://docs.openclaw.ai/gateway/configuration-reference