SPX MCP Server

Servidor MCP solo web para informes de php-spx. Llama a los endpoints web de SPX integrados, analiza el informe completo y devuelve resúmenes JSON de tamaño LLM en lugar de flujos de eventos sin procesar.

Requisitos previos

• Node.js 20 o superior

• Una aplicación con la extensión PHP spx habilitada para la creación de perfiles HTTP

• Acceso HTTP de SPX configurado, por ejemplo:

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

Related MCP server: otel-mcp

Compilación

npm install
npm run build

El punto de entrada stdio compilado es:

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

Establezca estas variables de entorno en la configuración de su agente, o páselas por llamada de herramienta:

SPX_BASE_URL=http://localhost
SPX_KEY=dev

Instalación en Codex CLI

Edite ~/.codex/config.toml y añada:

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

Reinicie Codex CLI después de editar el archivo.

Instalación en Claude Code

Configuración del proyecto local:

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

Configuración para todo el usuario:

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

Verificar:

claude mcp list
claude mcp get spx

Configuración de proyecto equivalente en .mcp.json:

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

Instalación en Cline

Cline es un popular agente de código abierto para VS Code con soporte MCP.

Para Cline CLI, ejecute:

cline mcp

Luego añada un servidor stdio local con:

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

Para la extensión de VS Code, abra la configuración de Servidores MCP de Cline y añada este JSON:

{
  "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": []
    }
  }
}

Instalación en OpenClaw

OpenClaw es un agente/puerta de enlace personal de código abierto que puede gestionar servidores MCP salientes bajo mcp.servers.

Edite ~/.openclaw/openclaw.json o el archivo señalado por OPENCLAW_CONFIG_PATH:

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

Verifique la configuración guardada:

openclaw mcp status --verbose
openclaw mcp probe spx

Flujo de trabajo básico

1. Llame a profile_url para la URL web que desea perfilar.

2. Llame a list_reports.

3. Seleccione el informe coincidente más reciente.

4. Llame a analyze_report o get_hot_paths.

Herramientas

• profile_url: envía una solicitud HTTP con las cookies de SPX habilitadas.

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

• get_report_metadata: lee un JSON de metadatos de informe.

• analyze_report: descarga y analiza ?SPX_UI_URI=/data/reports/get/<key>.

• get_hot_paths: devuelve las rutas de llamada más costosas.

• get_function_profile: devuelve el agregado de una función y sus llamantes/llamados.

• get_raw_events: devuelve un segmento de depuración paginado de eventos sin procesar.

El analizador limita la salida por defecto. Los informes grandes de SPX pueden contener millones de eventos, por lo que la salida completa del informe sin procesar no se expone intencionalmente como resultado normal de una herramienta. get_raw_events está limitado a 1000 eventos por llamada y está destinado a depurar el comportamiento del analizador o del parser.

Referencias

• Configuración MCP de Claude Code: https://code.claude.com/docs/en/mcp

• Configuración MCP de Cline: https://github.com/cline/cline/blob/main/docs/mcp/mcp-overview.mdx

• Configuración MCP de OpenClaw: https://docs.openclaw.ai/gateway/configuration-reference