FusionReactor MCP Server
A TypeScript Model Context Protocol (MCP) server that exposes FusionReactor Cloud monitoring data — metrics, logs, and alerts — as callable tools for AI assistants.
Features
| Category | Tools | Backend | |----------|-------|---------| | Metrics | query_metrics, query_metrics_range, list_metric_series, list_metric_label_names, list_metric_label_values | Prometheus / Mimir API | | Logs | query_logs, query_logs_range, list_log_label_names, list_log_label_values, list_log_series | Loki API | | Alerts | list_alert_rules, list_alert_rules_by_namespace, get_alerts, get_alert_groups | Grafana Alerting API |
Prerequisites
- Node.js ≥ 18
- A FusionReactor Cloud account with an API key
Quick Start
# 1. Install dependencies
npm install
# 2. Build
npm run build
# 3. Run (requires API key)
FUSIONREACTOR_API_KEY=your-key-here npm startEnvironment Variables
| Variable | Required | Description | |----------|----------|-------------| | FUSIONREACTOR_API_KEY | Yes | Your FusionReactor API key | | FUSIONREACTOR_API_URL | No | API base URL. Defaults to https://api.fusionreactor.io |
Using with an MCP Client
Add this server to your MCP client configuration. For example, in Claude Desktop or VS Code:
{
"mcpServers": {
"fusionreactor": {
"command": "node",
"args": ["<path-to-project>/dist/index.js"],
"env": {
"FUSIONREACTOR_API_KEY": "your-key-here"
}
}
}
}Development
# Watch mode — recompiles on file changes
npm run dev
# One-time build
npm run buildProject Structure
src/
├── index.ts # Entry point — bootstraps MCP server with stdio transport
├── client.ts # FusionReactor HTTP API client (metrics, logs, alerts)
└── tools.ts # MCP tool definitions wired to the API clientAPI Endpoints Used
The server communicates with FusionReactor Cloud's Grafana-compatible API:
- Metrics —
/g/api/v1/query,/g/api/v1/query_range,/g/api/v1/series,/g/api/v1/labels,/g/api/v1/label/{name}/values - Logs —
/g/loki/api/v1/query,/g/loki/api/v1/query_range,/g/loki/api/v1/labels,/g/loki/api/v1/label/{name}/values,/g/loki/api/v1/series - Alerts —
/g/api/ruler/grafana/api/v1/rules,/g/api/alertmanager/grafana/api/v2/alerts,/g/api/alertmanager/grafana/api/v2/alerts/groups
License
MIT
