MCP Ansible

What it does

This MCP server connects AI agents directly to Ansible, allowing them to manage infrastructure as code. It provides a comprehensive suite of tools to create, validate, and execute playbooks, manage inventories, and perform advanced system diagnostics across a fleet of servers without leaving the AI interface.

Tools

• create-playbook: Generates Ansible playbooks from YAML strings.
• ansible-playbook: Executes defined playbooks against target hosts.
• ansible-task: Runs ad-hoc Ansible modules (e.g., ping, shell).
• ansible-inventory: Lists and parses inventory hosts and groups.
• ansible-diagnose-host: Performs a comprehensive health assessment with scoring.
• ansible-auto-heal: Intelligent automated problem resolution for common system issues.
• ansible-security-audit: Conducts vulnerability assessments and compliance checks.
• ansible-remote-command: Executes shell commands with enhanced output parsing.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "ansible-mcp": {
      "command": "python",
      "args": [
        "/path/to/mcp-ansible/src/ansible_mcp/server.py"
      ],
      "env": {
        "MCP_ANSIBLE_PROJECT_ROOT": "/path/to/your/ansible-project",
        "MCP_ANSIBLE_INVENTORY": "/path/to/your/inventory/hosts.ini",
        "MCP_ANSIBLE_PROJECT_NAME": "my-project"
      }
    }
  }
}

Supported hosts

• Claude Desktop
• Cursor