spx-mcp-server
SPX MCP Server
php-spx 보고서를 위한 웹 전용 MCP 서버입니다. 내장된 SPX 웹 엔드포인트를 호출하고 전체 보고서를 파싱하여 원시 이벤트 스트림 대신 LLM 크기의 JSON 요약을 반환합니다.
전제 조건
Node.js 20 이상
HTTP 프로파일링을 위해
spxPHP 확장이 활성화된 애플리케이션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=devCodex 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=devVS 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기본 워크플로우
프로파일링하려는 웹 URL에 대해
profile_url을 호출합니다.list_reports를 호출합니다.가장 최근의 일치하는 보고서를 선택합니다.
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개의 이벤트로 제한되며 파서 또는 분석기 동작을 디버깅하기 위한 것입니다.
참고 자료
Claude Code MCP 구성: https://code.claude.com/docs/en/mcp
Cline MCP 구성: https://github.com/cline/cline/blob/main/docs/mcp/mcp-overview.mdx
OpenClaw MCP 구성: https://docs.openclaw.ai/gateway/configuration-reference
Maintenance
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
- Alicense-qualityBmaintenanceAn 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.1MIT
- AlicenseAqualityDmaintenanceMCP server that gives AI agents access to your application's OpenTelemetry traces for querying, analysis, and debugging.5262MIT
- Alicense-qualityBmaintenanceMCP server that exposes Symfony profiler runtime data (requests, queries, logs) to AI agents like Claude Code for debugging and optimization.MIT
- Alicense-qualityDmaintenanceRemote MCP server that normalizes OpenTelemetry GenAI spans by mapping fields, provider attributes, and missing attributes, and exports dashboard schemas.MIT
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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