Skip to content

rootio-avr/mcp-proxy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Root.io Logo Root.io MCP Server & Proxy

MIT License Docker Hub Project Status

πŸš€ Seamlessly connect Claude (and other AI clients like Cursor) to Root.io's powerful container security platform through the Model Context Protocol (MCP).

🌟 Overview

The Root.io MCP solution provides AI-powered container security capabilities directly within AI clients like Claude, Cursor, and more. This integration enables you to:

  • πŸ›‘οΈ Automated Remediation: Apply security patches and fixes automatically
  • πŸ” Vulnerability Scanning: Analyze container images for security vulnerabilities
  • πŸ“Š Security Reporting: Generate comprehensive security reports and analysis
  • πŸ”„ Continuous Monitoring: Track remediation progress and maintain security posture

About Root.io

Root.io is the leading container security platform that automatically patches vulnerabilities in your container images. Our AI-powered platform:

  • βœ… Scans container images for known vulnerabilities
  • πŸ”§ Applies security patches without breaking functionality
  • πŸš€ Integrates seamlessly with your existing CI/CD pipelines
  • πŸ“ˆ Provides actionable security insights and compliance reporting
  • πŸ›‘οΈ Maintains zero-trust security posture for containerized applications

πŸš€ Getting Started

Option 1: πŸ“¦ Docker MCP (Recommended)

The easiest way to get started is using our published MCP from the catalog:

Prerequisites

  1. 🐳 Docker Desktop: Install Docker Desktop from Docker.com

  2. πŸ“¦ Docker MCP Toolkit: Configure the Docker MCP Toolkit with the clients you want to use

    Docker Desktop Clients

  3. 🏒 Root.io Account: Sign up at app.root.io to get your API access token

Steps

  1. πŸ“¦ Docker Catalog: Navigate on Docker Desktop under MCP Toolkit --> Catalog and search for "root" 🌱

  2. βž• Add MCP: Click the Plus button to add the MCP server

    Root MCP

  3. πŸ“ Configure: Enter your Root.io API token πŸ”‘

    • Log into your Root.io account
    • Click your profile
    • Generate a new API token for MCP integration
    • Paste it in the Docker Desktop Root.io MCP configuration

Option 2: πŸ”§ Standalone Setup

Alternatively, you can run the MCP server standalone using our Docker image:

{
  "mcpServers": {
    "rootio-mcp": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "API_ACCESS_TOKEN",
        "mcp/root"
      ],
      "env": {
        "API_ACCESS_TOKEN": "<your_root_api_token>"
      }
    }
  }
}

Configuration Steps

  1. Configure Your AI Client βš™οΈ

    • Open Claude Desktop (or your preferred AI client)
    • Go to Settings β†’ Developer β†’ MCP Servers
    • Add the configuration JSON above
    • Keep the settings open for the next step
  2. Get Your API Token πŸ”‘

    • Log into your Root.io account
    • Click your profile
    • Generate a new API token for MCP integration
    • Replace <your_root_api_token> in your AI client configuration with the copied token
  3. Start Using πŸŽ‰

    • Restart Claude Desktop
    • Start a new conversation
    • Ask Claude to scan a container image or check your security posture!

πŸ” Example Usage

πŸ“ "Visualize a vulnerability report for my-org/backend:latest"
πŸ“ "Show me the security status of my organization's images"
πŸ“ "Remediate my image my-org/backend:latest"

πŸ—οΈ Architecture

The Root.io MCP solution consists of two main components working together:

πŸ”„ Data Flow

AI Client β†’ MCP Proxy β†’ Remote MCP Server β†’ Root.io API
  1. πŸ€– AI Client: Your AI interface for security operations (Claude Desktop, Cursor, etc.)
  2. πŸ”— MCP Proxy: Handles authentication and request routing
  3. πŸš€ Remote MCP Server: Processes security commands and API calls
  4. 🏒 Root.io System: Performs vulnerability scanning and remediation

πŸ›‘οΈ Security Features

  • πŸ” Token-based Authentication: Secure API access with bearer tokens
  • πŸ”’ TLS Encryption: All communications encrypted in transit
  • 🎯 Scoped Permissions: API tokens have limited, specific permissions
  • πŸ” Audit Logging: Complete audit trail of all security operations

🎯 Capabilities

πŸ” Security Operations

  • Vulnerability Assessment: Comprehensive scanning of container images for known security issues
  • Automated Remediation: Intelligent patching and security fixes without breaking functionality
  • Progress Monitoring: Real-time tracking of remediation processes and results
  • Registry Management: Support for both public and private container registries

πŸ“Š Analysis & Intelligence

  • Security Reporting: Detailed vulnerability reports and remediation summaries
  • Compliance Tracking: Monitor security posture across your container inventory
  • Trend Analysis: Historical security data and improvement tracking
  • Risk Assessment: Prioritized vulnerability information with severity ratings

πŸ“ˆ Project Status

This project is actively maintained by the Root.io team. We regularly release updates with:

  • πŸ†• New Features: Enhanced security capabilities and AI integrations
  • πŸ› Bug Fixes: Continuous improvement and reliability updates
  • πŸ”’ Security Updates: Latest security patches and improvements
  • πŸ“š Documentation: Comprehensive guides and examples
  • πŸš€ Performance Improvements: Fast and efficient performance

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


drawing

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors