AAP Enterprise MCP Server

A comprehensive Model Context Protocol (MCP) server suite for Red Hat's automation and infrastructure ecosystem, enabling AI assistants to interact with Ansible Automation Platform (AAP), Event-Driven Ansible (EDA), ansible-lint code quality tools, and Red Hat's official documentation with secure domain validation.

Features

Ansible Automation Platform (AAP) Integration

• Inventory Management: List, create, update inventories and manage hosts/groups
• Job Management: Run job templates, monitor job status, and retrieve logs
• Project Management: Create and manage SCM-based projects
• Template Management: Create and manage job templates
• Host Operations: Add/remove hosts, manage host variables and facts
• Ad-hoc Commands: Execute ansible commands directly on inventory hosts

Event-Driven Ansible (EDA) Integration

• Activation Management: List, create, enable/disable EDA activations
• Rulebook Management: Manage and query rulebooks
• Decision Environment Management: Manage decision environments
• Event Stream Monitoring: Monitor event streams

Ansible Galaxy Integration

• Collection Search: Search and discover Ansible collections by name, namespace, or keywords
• Role Search: Find community roles by keyword, author, or specific criteria
• Content Details: Get comprehensive information about collections and roles including versions, dependencies, and installation instructions
• Smart Suggestions: AI-powered content recommendations based on use case descriptions
• AAP Integration: Intelligent suggestions that consider existing AAP infrastructure and inventories

Ansible Lint Integration

• Playbook Validation: Real-time linting of Ansible playbook content with configurable quality profiles
• File Analysis: Comprehensive analysis of Ansible files, roles, and entire project structures
• Best Practice Enforcement: Automated checking against Ansible community standards and best practices
• Syntax Validation: Quick syntax checking for immediate feedback during development
• Multi-Profile Support: Progressive quality improvement with profiles from basic to production-ready
• Rule Management: List, filter, and understand ansible-lint rules with detailed explanations

Red Hat Documentation Integration (Streamlined)

• Efficient Discovery: Web search-based content discovery using official Red Hat domains
• Smart Content Fetching: PDF-first strategy handling Red Hat's JavaScript rendering issues
• Domain Security: Validates access to 50+ official Red Hat domains for secure documentation access
• Minimal MCP Overhead: Streamlined 2-tool approach reduces API calls by 75%
• Search Query Generation: Creates optimized search queries for external WebSearch MCP tool usage
• Authentication Handling: Smart detection of subscription-required vs public content

Installation

Prerequisites

• Python 3.11 or higher
• UV package manager (recommended) or pip
• Access to an Ansible Automation Platform instance
• Valid AAP API token

Setup

1. Clone the repository:

   git clone https://github.com/sibilleb/AAP-Enterprise-MCP-Server.git
   cd AAP-Enterprise-MCP-Server
   

2. Install dependencies:

   # Using UV (recommended)
   uv sync
   
   # Or using pip
   pip install -e .
   

3. Set up environment variables:

   # Required for AAP/EDA servers
   export AAP_TOKEN="your-aap-api-token"
   export AAP_URL="https://your-aap-server.com/api/controller/v2"
   export EDA_TOKEN="your-eda-api-token"  # Can be same as AAP_TOKEN
   export EDA_URL="https://your-aap-server.com/api/eda/v1"
   
   # Optional for Red Hat Customer Portal access
   export REDHAT_USERNAME="your-redhat-username"
   export REDHAT_PASSWORD="your-redhat-password"
   

Getting Your API Token

Method 1: AAP Web Interface

1. Log into your AAP web interface
2. Click on your

... View full README on GitHub