{"_id":"@access-mcp/xdmod-charts","_rev":"2-39dfd407d3b694da1a4bd7f8340b9170","name":"@access-mcp/xdmod-charts","dist-tags":{"latest":"0.5.0"},"versions":{"0.4.0":{"name":"@access-mcp/xdmod-charts","version":"0.4.0","keywords":["mcp","server","access-ci","xdmod","charts","visualizations","analytics"],"author":{"name":"ACCESS-CI"},"license":"MIT","_id":"@access-mcp/xdmod-charts@0.4.0","maintainers":[{"name":"sweetandfizzy","email":"andrew@sweetandfizzy.com"}],"homepage":"https://github.com/necyberteam/access-mcp/tree/main/packages/xdmod-charts","bugs":{"url":"https://github.com/necyberteam/access-mcp/issues"},"bin":{"access-xdmod-charts":"dist/index.js"},"dist":{"shasum":"d124cf75dd2b242b9f7e83412a14bf1c2a32e65b","tarball":"https://registry.npmjs.org/@access-mcp/xdmod-charts/-/xdmod-charts-0.4.0.tgz","fileCount":6,"integrity":"sha512-Uo6TTG6v/OL69FTYtOKISRi68P26zKrQCli3tOj1di2dCL2l1WJzYLTNTyjwi1OzX3TnelY+fj08GCAmAQACxA==","signatures":[{"sig":"MEQCICZhE00BvqxoYN7otLUfJ4Xg7bOydGH2T/8+xukVQDOCAiBPV3tatvJPx9OnjKHN8xzP7WArKg0lpLzJI52atSVIrg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35930},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"68dc3489ffc499541d9a9a743e3afa322ff813f1","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"sweetandfizzy","email":"andrew@sweetandfizzy.com"},"repository":{"url":"git+https://github.com/necyberteam/access-mcp.git","type":"git","directory":"packages/xdmod-charts"},"_npmVersion":"11.3.0","description":"MCP server for XDMoD Charts and Visualizations","directories":{},"_nodeVersion":"24.2.0","dependencies":{"@access-mcp/shared":"file:../shared"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/xdmod-charts_0.4.0_1757385183092_0.12472049327741441","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@access-mcp/xdmod-charts","version":"0.5.0","description":"MCP server for XDMoD Charts and Visualizations","type":"module","main":"dist/index.js","bin":{"access-xdmod-charts":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc --watch"},"keywords":["mcp","server","access-ci","xdmod","charts","visualizations","analytics"],"author":{"name":"ACCESS-CI"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/necyberteam/access-mcp.git","directory":"packages/xdmod-charts"},"homepage":"https://github.com/necyberteam/access-mcp/tree/main/packages/xdmod-charts","bugs":{"url":"https://github.com/necyberteam/access-mcp/issues"},"dependencies":{"@access-mcp/shared":"^0.3.3"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.0.0"},"_id":"@access-mcp/xdmod-charts@0.5.0","gitHead":"9224291b50a9c4c538241d2a93f8fb2dde8b69f8","types":"./dist/index.d.ts","_nodeVersion":"24.2.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-2kttwXhTOa7Gy+LSWwPiAhcsGRUbrrhXvjsz4Ae0PNmVxuHkeQja6FOAOzh/h2w0caJp3vrSnrn91Jj4jm8z4Q==","shasum":"7151829f8f83143593b3a0e789d05104fdf06811","tarball":"https://registry.npmjs.org/@access-mcp/xdmod-charts/-/xdmod-charts-0.5.0.tgz","fileCount":6,"unpackedSize":32836,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHzaYzZG0niJ+FYBrGyOxyFBGGp8YOCDtmNB53HV1iCjAiEAinZvdqQbp+Gv+rhU7vFf2JHTz2tjHtArlkchu+16VhA="}]},"_npmUser":{"name":"sweetandfizzy","email":"andrew@sweetandfizzy.com"},"directories":{},"maintainers":[{"name":"sweetandfizzy","email":"andrew@sweetandfizzy.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/xdmod-charts_0.5.0_1764187362983_0.7228791071586655"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-09T02:33:03.012Z","modified":"2025-11-26T20:02:43.398Z","0.4.0":"2025-09-09T02:33:03.272Z","0.5.0":"2025-11-26T20:02:43.184Z"},"bugs":{"url":"https://github.com/necyberteam/access-mcp/issues"},"author":{"name":"ACCESS-CI"},"license":"MIT","homepage":"https://github.com/necyberteam/access-mcp/tree/main/packages/xdmod-charts","keywords":["mcp","server","access-ci","xdmod","charts","visualizations","analytics"],"repository":{"type":"git","url":"git+https://github.com/necyberteam/access-mcp.git","directory":"packages/xdmod-charts"},"description":"MCP server for XDMoD Charts and Visualizations","maintainers":[{"name":"sweetandfizzy","email":"andrew@sweetandfizzy.com"}],"readme":"# XDMoD Charts MCP Server\n\nMCP server providing charts and visualizations from XDMoD (XD Metrics on Demand) Usage Analytics API endpoints for ACCESS-CI infrastructure. Generate SVG, PNG, and PDF charts, portal links, and advanced research visualizations with NSF Awards integration for comprehensive funding context.\n\n## Usage Examples\n\n### **Charts & Visualizations**\n\n```\n\"CPU hours chart for January 2024 (PNG)\"\n\"Job count data for last 30 days\"\n\"GPU usage SVG chart grouped by resource\"\n\"Average wait time visualization for Q1 2024\"\n```\n\n### **Portal Links**\n\n```\n\"XDMoD portal link for CPU hours chart\"\n\"Interactive GPU usage view in portal\"\n\"Job count chart link for Bridges-2\"\n```\n\n## Tools\n\n### get_chart_data\n\nGet chart data and metadata for a specific statistic.\n\n**Parameters:**\n\n- `realm` (string): The realm (e.g., \"Jobs\")\n- `group_by` (string): The group by field (e.g., \"none\")\n- `statistic` (string): The statistic name (e.g., \"total_cpu_hours\")\n- `start_date` (string): Start date in YYYY-MM-DD format\n- `end_date` (string): End date in YYYY-MM-DD format\n- `dataset_type` (string, optional): Dataset type (default: \"timeseries\")\n\n**Returns:** Raw chart data including descriptions and metadata.\n\n### get_chart_image\n\nGet chart image (SVG, PNG, or PDF) for a specific statistic.\n\n**Parameters:**\n\n- `realm` (string): The realm (e.g., \"Jobs\")\n- `group_by` (string): The group by field (e.g., \"none\")\n- `statistic` (string): The statistic name (e.g., \"total_cpu_hours\")\n- `start_date` (string): Start date in YYYY-MM-DD format\n- `end_date` (string): End date in YYYY-MM-DD format\n- `format` (string, optional): Image format - \"svg\", \"png\", or \"pdf\" (default: \"svg\"). Note: PNG displays directly in Claude Desktop, SVG returns as data URL and code, PDF returns as downloadable data\n- `width` (number, optional): Image width in pixels (default: 916)\n- `height` (number, optional): Image height in pixels (default: 484)\n- `dataset_type` (string, optional): Dataset type (default: \"timeseries\")\n\n**Returns:** Chart image data in the requested format.\n\n### get_chart_link\n\nGenerate a direct link to view the chart in the XDMoD portal.\n\n**Parameters:**\n\n- `realm` (string): The realm (e.g., \"Jobs\", \"SUPREMM\")\n- `group_by` (string): The group by field (e.g., \"none\", \"resource\")\n- `statistic` (string): The statistic name (e.g., \"total_cpu_hours\", \"gpu_time\")\n\n**Returns:** Direct URL to view the interactive chart in XDMoD. Use the portal's filtering options to narrow down to specific resources, users, or other criteria.\n\n## Understanding Realms\n\nXDMoD organizes metrics into different **realms** that provide different types of data:\n\n### **Jobs Realm** \nBasic job accounting and resource usage metrics:\n- `total_cpu_hours` - Total CPU Hours\n- `job_count` - Number of Jobs Ended\n- `avg_cpu_hours` - Average CPU Hours per Job\n- `total_waitduration_hours` - Total Wait Duration Hours\n- `avg_waitduration_hours` - Average Wait Duration Hours\n- `max_processors` - Maximum Processor Count\n- `total_ace` - ACCESS Credit Equivalents Charged: Total\n- `utilization` - ACCESS CPU Utilization\n\n### **SUPREMM Realm** \nDetailed performance analytics and system metrics:\n- `gpu_time` - **GPU Hours: Total** 🎯\n- `avg_percent_gpu_usage` - **Avg GPU usage: weighted by GPU hour** 🎯\n- `wall_time` - CPU Hours: Total\n- `cpu_time_user` - CPU Hours: User: Total\n- `avg_percent_cpu_user` - Avg CPU %: User: weighted by core-hour\n- `avg_flops_per_core` - Avg: FLOPS: Per Core weighted by core-hour\n- `avg_memory_per_core` - Avg: Memory: Per Core weighted by core-hour\n- `avg_ib_rx_bytes` - Avg: InfiniBand rate: Per Node weighted by node-hour\n\n**Note:** For GPU metrics, always use the SUPREMM realm.\n\n## Authentication\n\nNo authentication required. The server accesses publicly available system-wide metrics data from XDMoD.\n\n## License\n\nMIT\n\n## Installation\n\n```bash\nnpm install -g @access-mcp/xdmod-charts\n```\n\nAdd to your Claude Desktop configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"xdmod-charts\": {\n      \"command\": \"npx\",\n      \"args\": [\"@access-mcp/xdmod-charts\"]\n    }\n  }\n}\n```\n","readmeFilename":"README.md"}