{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3x4qxxs7mprg","handle":"spark-eventlog-mcp","url":"https://wellknown.network/agents/spark-eventlog-mcp","links":{"self":"https://wellknown.network/agents/spark-eventlog-mcp/record.json","html":"https://wellknown.network/agents/spark-eventlog-mcp","markdown":"https://wellknown.network/agents/spark-eventlog-mcp/record.md","api":"https://wellknown.network/api/v1/agents/spark-eventlog-mcp","status":"https://wellknown.network/api/v1/agents/spark-eventlog-mcp/status","claim":"https://wellknown.network/agents/spark-eventlog-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/spark-eventlog-mcp/claim.json","badge":"https://wellknown.network/agents/spark-eventlog-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/spark-eventlog-mcp/history","tools":"https://wellknown.network/api/v1/agents/spark-eventlog-mcp/tools"},"ard":{"identifier":"urn:air::server:spark-eventlog-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"spark-eventlog-mcp","summary":"A comprehensive Spark event log analysis MCP server with performance monitoring and optimization recommendations","description":"# Spark EventLog MCP Server\n\n[中文版本](README_zh.md) | English\n\nA comprehensive Spark event log analysis MCP server built on FastMCP 2.0 and FastAPI, providing in-depth performance analysis, resource monitoring, and optimization recommendations.\n\n## Features\n\n- 🌐 **FastMCP & FastAPI Integration**: MCP protocol support and analysis report APIs powered by FastAPI & FastMCP\n- 📊 **Performance Analysis**: Shuffle analysis, resource utilization monitoring, task execution analysis\n- 📈 **Visual Reports**: Auto-generated interactive HTML reports with direct browser access\n- ☁️ **Multiple Data Sources**: Support for S3, HTTP URLs, and local files\n- 💡 **Intelligent Optimization**: Automated optimization recommendations based on analysis results\n\n## Quick Start\n\n### MCP Client Integration\n\n#### stdio Mode (Recommended for Local Development)\n\n```json\n{\n  \"mcpServers\": {\n    \"spark-eventlog\": {\n      \"command\": \"uv run python\",\n      \"args\": [\"/path/to/spark-eventlog-mcp/start.py\"],\n      \"env\": {\n        \"MCP_TRANSPORT\": \"stdio\"\n      }\n    }\n  }\n}\n```\n\n#### HTTP Mode\n\n**1. Start HTTP Server:**\n\n```bash\nexport MCP_TRANSPORT=streamable-http\nexport MCP_HOST=localhost\nexport MCP_PORT=7799\n\nuv run python start.py\n```\n\n**2. Configure Remote MCP:**\n\n```json\n{\n  \"mcpServers\": {\n    \"spark-eventlog\": {\n      \"url\": \"http://localhost:7799/mcp\",\n      \"type\": \"http\"\n    }\n  }\n}\n```\n\n**3. Access Services:**\n\n- API Documentation: http://localhost:7799/docs\n- Health Check: http://localhost:7799/health\n- Reports List: http://localhost:7799/api/reports\n- MCP Endpoint: http://localhost:7799/mcp\n\n## Analysis Examples\n\n![emr-serverless-small-job](https://pcmyp.oss-cn-beijing.aliyuncs.com/markdown/Screenshot%202025-12-06%20at%2015-12-46%20Spark%20Event%20Log%20Analysis%20Report.png)\n\n![emr-eks-big-job](https://pcmyp.oss-cn-beijing.aliyuncs.com/markdown/Screenshot%202025-12-06%20at%2015-10-42%20Spark%20Event%20Log%20Analysis%20Report.png)\n\n![emr-eks-big-job-sub-01](https://pcmyp.oss-cn-beijing.al…","publisher":null,"homepage":"https://github.com/yhyyz/spark-eventlog-mcp#readme","repository":"https://github.com/yhyyz/spark-eventlog-mcp/issues","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["spark","eventlog","analysis","mcp","performance","monitoring"],"pricing":null,"endpoints":[{"url":"pypi:spark-eventlog-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.monitoring","name":"Monitoring & Observability","confidence":1,"provenance":"declared"},{"slug":"code.documentation","name":"Code Documentation","confidence":0.848,"provenance":"derived"}],"categories":["code","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"spark-eventlog-mcp","registry":"pypi","observedAt":"2026-11-04T01:24:48.799Z","publishedAt":"2025-12-06T08:21:39.248488Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"spark-eventlog-mcp","url":"https://pypi.org/project/spark-eventlog-mcp/","firstSeenAt":"2026-09-10T12:23:07.050Z","fetchedAt":"2026-11-04T01:23:06.707Z","normalizedAt":"2026-11-04T01:23:06.707Z"}]},"firstSeenAt":"2026-09-10T12:23:07.050Z","updatedAt":"2026-11-04T01:24:48.799Z"}