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

Related MCP server: mcp-cloudwatch-explorer

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 start

Environment Variables

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 build

Project 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 client

API 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