Monti APM MCP Server

SDUI MCP Monti APM Server

A Model Context Protocol (MCP) server that integrates with Monti APM to provide AI assistants with access to your Meteor application's performance monitoring data.

Overview

This MCP server exposes Monti APM data through the Model Context Protocol, allowing AI assistants like Claude Desktop to:

• Retrieve system metrics (RAM, CPU, network, disk usage)
• Query method execution traces for performance analysis
• Access application errors and exceptions
• Execute custom GraphQL queries against the Monti APM API
• Get application information and configuration

Features

• 🔐 Secure Authentication: JWT-based authentication with Monti APM API
• 📊 System Metrics: Real-time performance monitoring data
• 🔍 Method Tracing: Detailed execution traces for performance debugging
• 🚨 Error Monitoring: Application errors and exceptions tracking
• 🛠️ Custom Queries: Execute custom GraphQL queries against Monti APM
• 📝 Comprehensive Logging: Structured logging with Winston
• 🔄 Resource Caching: Efficient data retrieval with smart caching

Prerequisites

• Node.js 18+
• Existing Meteor application with Monti APM monitoring configured
• Monti APM App ID and App Secret credentials

Installation

1. Clone and Install Dependencies

git clone <repository-url>
cd sdui-mcp-monti-apm
npm install

2. Environment Configuration

Copy the example environment file and configure your credentials:

cp .env.example .env

Edit .env with your Monti APM credentials:

# Monti APM Configuration
MONTI_APP_ID=your_app_id_here
MONTI_APP_SECRET=your_app_secret_here
MONTI_API_URL=https://api.montiapm.com/core
MONTI_AUTH_URL=https://api.montiapm.com/auth

# Server Configuration  
PORT=4002
NODE_ENV=development

# Logging
LOG_LEVEL=info
LOG_FILE=./logs/mcp-monti.log

3. Build the Project

npm run build

4. Test the Server

npm start

Usage

With Claude Desktop

Add the server to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "monti-apm": {
      "command": "node",
      "args": ["/path/to/sdui-mcp-monti-apm/dist/index.js"],
      "env": {
        "MONTI_APP_ID": "your_app_id",
        "MONTI_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Available Tools

1. Get System Metrics

getSystemMetrics(metric: 'RAM_USAGE' | 'CPU_USAGE' | 'NETWORK_IN' | 'NETWORK_OUT' | 'DISK_USAGE')

Retrieve system performance metrics with optional filtering by host and time range.

2. Get Method Traces

getMethodTraces(options?: { minDuration, maxDuration, host, userId, limit, since, until })

Analyze method execution traces to identify performance bottlenecks.

3. Get Application Errors

getErrors(options?: { limit, since, until, host, resolved })

Retrieve application errors and exceptions for debugging.

4. Run Custom Query

runMontiQuery(query: string, variables?: object)

Execute custom GraphQL queries against the Monti APM API.

5. Get App Info

getAppInfo()

Retrieve basic information about your monitored application.

6. Get Available Hosts

getAvailableHosts()

List all monitored hosts to identify development vs production deployments.

Host Filtering for Multi-Environment Monitoring

This MCP server supports filtering data by deployment host, perfect for separating development and production monitoring:

// List available hosts
getAvailableHosts()
// Returns: Development hosts (e.g., "MBPvonJMichael2.pioneers") and Production hosts

// Development environment monitoring
getSystemMetrics({host: "MBPvonJMichael2.pioneers", metric: "RAM_USAGE"})
getMethodTraces({host: "MBPvonJMichael2.pioneers", limit: 20})
getErrors({host: "MBPvonJMichael2.pioneers", limit: 10})

// Production environment monitoring
getSystemMetrics({host: "plaiground01-plAIground", metric: "RAM_USAGE"})
getMethodTraces({host: "plaiground01-plAIground", limit: 20})
getErrors({host: "plaiground01-plAIground", limit: 10})

// Compare CPU usage across environments
getSystemMetrics({host: "MBPvonJMichael2.pioneers", metric: "CPU_USAGE"})      // Dev
getSystemMetrics({host: "plaiground01-plAIground", metric: "CPU_USAGE"})       // Prod

Available Resources

• monti://metric/{metric_type} - Access cached metric data
• monti://trace/{trace_id} - Individual method trace details
• monti://error/{error_id} - Specific error details
• monti://app - Application information

Development

Scripts

# Development with hot reload
npm run dev

# Build for production
npm run build

# Start production server
npm start

# Lint code
npm run lint

# Format code
npm run format

Project Structure

src/
├── lib/
│   ├── logger.ts          # Winston logging configuration
│   ├── montiAuth.ts       # JWT authentication with Monti APM