A community MCP server for AWX (awx-mcp)

Project Discussions
, , ,
1

Hello, Forks

I wanted to share something I’ve been working on recently.

awx-mcp is an open-source MCP server for AWX. It lets an LLM interact with an AWX instance through the AWX REST API v2.

Repository

The reason I built this is pretty simple.
Red Hat already has an MCP server for Ansible Automation Platform, but it is focused on AAP rather than upstream AWX.
I run open-source AWX directly and kept hoping someone would build an AWX-focused version, so I decided to make one myself.

This is an open-source project hosted under the lycorp-jp GitHub organization.
It is intended for upstream AWX users and is not affiliated with or endorsed by Red Hat.

A few things it supports

  • 146 tools covering inventories, hosts, groups, job templates, … (All APIs)
  • Works with MCP clients such as Claude Desktop, Claude Code, and Cline
  • Supports STDIO, SSE, and Streamable HTTP
  • Lets you ask things in plain language, such as “Show the hosts in the Production inventory” or “Launch the Deploy App template and show me the log”

I know the idea of letting an LLM touch real infrastructure can feel risky, so the defaults are intentionally conservative.

  • Read-only mode is enabled with AWX_MCP_READ_ONLY=true
  • In read-only mode, only list_* and get_* tools are exposed
  • Credential and user-writing tools are opt-in and disabled by default
  • AWX RBAC still applies to every request through the configured token

It is currently developed and tested against AWX 24.6.1. I plan to keep it updated as AWX evolves.

If you try it, I’d really appreciate feedback, issues, or PRs.

And if this does not fit the community guidelines or is not the right category, please point me to a better place.

thx!