SPX MCP Server

Веб-ориентированный MCP-сервер для отчетов php-spx. Он вызывает встроенные веб-конечные точки SPX, разбирает полный отчет и возвращает JSON-сводки, оптимизированные для LLM, вместо необработанных потоков событий.

Предварительные требования

• Node.js 20 или новее

• Приложение с включенным расширением PHP spx для HTTP-профилирования

• Настроен HTTP-доступ к SPX, например:

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

Related MCP server: otel-mcp

Сборка

npm install
npm run build

Встроенная точка входа stdio:

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

Установите эти переменные окружения в конфигурации вашего агента или передавайте их при каждом вызове инструмента:

SPX_BASE_URL=http://localhost
SPX_KEY=dev

Установка в Codex CLI

Отредактируйте ~/.codex/config.toml и добавьте:

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

Перезапустите Codex CLI после изменения файла.

Установка в Claude Code

Локальная конфигурация проекта:

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

Общесистемная конфигурация:

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

Проверка:

claude mcp list
claude mcp get spx

Эквивалентная конфигурация проекта .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"
      }
    }
  }
}

Установка в Cline

Cline — это популярный открытый VS Code-агент с поддержкой MCP.

Для Cline CLI выполните:

cline mcp

Затем добавьте локальный stdio-сервер:

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

Для расширения VS Code откройте настройки MCP-серверов Cline и добавьте этот 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": []
    }
  }
}

Установка в OpenClaw

OpenClaw — это открытый персональный агент/шлюз, который может управлять исходящими MCP-серверами в разделе mcp.servers.

Отредактируйте ~/.openclaw/openclaw.json или файл, указанный в 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",
        },
      },
    },
  },
}

Проверьте сохраненную конфигурацию:

openclaw mcp status --verbose
openclaw mcp probe spx

Базовый рабочий процесс

1. Вызовите profile_url для URL веб-страницы, которую нужно профилировать.

2. Вызовите list_reports.

3. Выберите последний подходящий отчет.

4. Вызовите analyze_report или get_hot_paths.

Инструменты

• profile_url: отправляет один HTTP-запрос с включенными SPX-куки.

• list_reports: читает ?SPX_UI_URI=/data/reports/metadata.

• get_report_metadata: читает JSON-метаданные одного отчета.

• analyze_report: загружает и разбирает ?SPX_UI_URI=/data/reports/get/<key>.

• get_hot_paths: возвращает наиболее затратные пути вызовов.

• get_function_profile: возвращает агрегированные данные одной функции, а также её вызывающих и вызываемых.

• get_raw_events: возвращает постраничный отладочный срез необработанных событий.

Анализатор по умолчанию ограничивает вывод. Большие отчеты SPX могут содержать миллионы событий, поэтому полный необработанный вывод отчета намеренно не предоставляется в качестве обычного результата работы инструмента. get_raw_events ограничен 1000 событий за вызов и предназначен для отладки поведения парсера или анализатора.

Ссылки

• Конфигурация MCP для Claude Code: https://code.claude.com/docs/en/mcp

• Конфигурация MCP для Cline: https://github.com/cline/cline/blob/main/docs/mcp/mcp-overview.mdx

• Конфигурация MCP для OpenClaw: https://docs.openclaw.ai/gateway/configuration-reference