Skip to main content
Glama
szepeviktor

spx-mcp-server

by szepeviktor

SPX MCP Server

php-spx 보고서를 위한 웹 전용 MCP 서버입니다. 내장된 SPX 웹 엔드포인트를 호출하고 전체 보고서를 파싱하여 원시 이벤트 스트림 대신 LLM 크기의 JSON 요약을 반환합니다.

전제 조건

  • Node.js 20 이상

  • HTTP 프로파일링을 위해 spx PHP 확장이 활성화된 애플리케이션

  • SPX HTTP 접근이 구성되어 있어야 합니다. 예:

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은 MCP를 지원하는 인기 있는 오픈소스 VS Code 에이전트입니다.

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 확장의 경우 Cline MCP 서버 설정을 열고 다음 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.servers 아래에서 아웃바운드 MCP 서버를 관리할 수 있는 오픈소스 개인 에이전트/게이트웨이입니다.

~/.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. 프로파일링하려는 웹 URL에 대해 profile_url을 호출합니다.

  2. list_reports를 호출합니다.

  3. 가장 최근의 일치하는 보고서를 선택합니다.

  4. analyze_report 또는 get_hot_paths를 호출합니다.

도구

  • profile_url: SPX 쿠키를 활성화하여 하나의 HTTP 요청을 보냅니다.

  • 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개의 이벤트로 제한되며 파서 또는 분석기 동작을 디버깅하기 위한 것입니다.

참고 자료

Install Server
A
license - permissive license
B
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    B
    maintenance
    An MCP server that converts Windows WPR .etl performance traces into structured JSON summaries and flamegraph-ready data for LLM analysis. It bridges Windows Performance Analyzer automation with LLM reasoning capabilities for performance troubleshooting.
    1
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    MCP server that gives AI agents access to your application's OpenTelemetry traces for querying, analysis, and debugging.
    5
    26
    2
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    Remote MCP server that normalizes OpenTelemetry GenAI spans by mapping fields, provider attributes, and missing attributes, and exports dashboard schemas.
    MIT

View all related MCP servers

Related MCP Connectors

  • Remote MCP for GenAI span mapping, provider normalization, dashboard schemas, and receipts.

  • MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.

  • AI Reasoning Cache & Consensus Layer with 11 MCP tools via Streamable HTTP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/szepeviktor/spx-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server