MCP Server for Coroot

A Model Context Protocol (MCP) server that provides seamless integration with Coroot observability platform. This server enables MCP clients to monitor applications, analyze performance metrics, examine logs and traces, and manage infrastructure through Coroot's comprehensive API.

Getting Started

Add this configuration to your MCP client settings:

{
  "mcpServers": {
    "coroot": {
      "command": "uvx",
      "args": ["mcp-coroot"],
      "env": {
        "COROOT_BASE_URL": "http://localhost:8080",
        "COROOT_USERNAME": "admin",
        "COROOT_PASSWORD": "your-password"
      }
    }
  }
}

Using Docker:

{
  "mcpServers": {
    "coroot": {
      "command": "docker",
      "args": ["run", "--rm", "-i", 
              "-e", "COROOT_BASE_URL=http://localhost:8080",
              "-e", "COROOT_USERNAME=admin",
              "-e", "COROOT_PASSWORD=your-password",
              "jamesbrink/mcp-coroot:latest"]
    }
  }
}

For SSO/MFA users, use session cookie authentication instead:

{
  "mcpServers": {
    "coroot": {
      "command": "uvx",
      "args": ["mcp-coroot"],
      "env": {
        "COROOT_BASE_URL": "http://localhost:8080",
        "COROOT_SESSION_COOKIE": "your-auth-cookie-value"
      }
    }
  }
}

Environment Variables

• COROOT_BASE_URL - Your Coroot instance URL (required)
• COROOT_USERNAME - Username for basic authentication
• COROOT_PASSWORD - Password for basic authentication
• COROOT_SESSION_COOKIE - Session cookie for SSO/MFA users
• COROOT_API_KEY - API key (limited to data ingestion only)

That's it! Your MCP client can now interact with your Coroot instance.

Features

Core Capabilities

• Application Monitoring - Real-time metrics, health checks, and performance analysis
• Log Analysis - Search, filter, and analyze application logs with pattern detection
• Distributed Tracing - Trace requests across microservices and identify bottlenecks
• Infrastructure Overview - Monitor nodes, containers, and system resources
• Incident Management - Track and analyze incidents with root cause analysis
• Performance Profiling - CPU and memory profiling with flame graphs

Management Features

• Project Management - Create, configure, and manage Coroot projects
• Integration Configuration - Set up Prometheus, Slack, PagerDuty, and more
• Dashboard Customization - Create and manage custom dashboards
• Cost Tracking - Monitor cloud costs with custom pricing rules
• User & Access Control - Manage users, roles, and permissions

Advanced Features

• AI-Powered RCA - Automatic root cause analysis for application issues
• Risk Assessment - Identify and track infrastructure and application risks
• Deployment Tracking - Monitor deployments and their impact
• SLO Management - Configure and track Service Level Objectives
• Database Instrumentation - Specialized monitoring for databases

Installation

Using uvx (Recommended)

# Install and run directly
uvx mcp-coroot

Using pip

pip install mcp-coroot

Using Docker

docker run --rm -i \
  -e COROOT_BASE_URL="http://localhost:8080" \
  -e COROOT_USERNAME="admin" \
  -e COROOT_PASSWORD="your-password" \
  jamesbrink/mcp-coroot:latest

From Source

git clone https://github.com/jamesbrink/mcp-coroot.git
cd mcp-coroot
uv sync --all-groups
uv run m

... [View full README on GitHub](https://github.com/jamesbrink/mcp-coroot#readme)