surgex-labs/awx-mcp-server

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

14 stars 13 forks 质量 60 趋势 20

Repository Install

VSCode extention and standalong mcp server to AWX

概览

The AWX MCP Server connects , , and to AI tools, giving AI agents and assistants the ability to manage job templates, launch and monitor jobs, manage inventories and projects, and automate infrastructure workflows through natural language interactions. : AI assistants (GitHub Copilot, Claude, Cursor) + AWX automation : - ✅ Works with any MCP client (Copilot, Claude, Cursor, Windsurf, etc.) - ✅ Industry standard pattern (STDIO transport) - ✅ Simple installation: pip install git+https://github.com/USERNAME/awx-mcp-server.

README

以下为原文 README 节选，完整内容请查看原文。

AWX MCP - AI-Powered AWX/AAP/Ansible Automation

Industry-standard MCP server for AWX/AAP/Ansible Tower automation

The AWX MCP Server connects AWX, Ansible Automation Platform (AAP), and Ansible Tower to AI tools, giving AI agents and assistants the ability to manage job templates, launch and monitor jobs, manage inventories and projects, and automate infrastructure workflows through natural language interactions.

Designed for developers who want to integrate their AI tools with AWX/AAP/Tower automation capabilities.

✨ Supports AWX (open source), AAP (Red Hat), and Ansible Tower (legacy) - same API, same features!

🎯 Usage Patterns

Primary: MCP Server (Industry Standard) ⭐ RECOMMENDED

Standard MCP implementation using STDIO transport (like Postman MCP, Claude MCP)

Use Case: AI assistants (GitHub Copilot, Claude, Cursor) + AWX automation

Features:

✅ Works with any MCP client (Copilot, Claude, Cursor, Windsurf, etc.)
✅ Industry standard pattern (STDIO transport)
✅ Simple installation: pip install git+https://github.com/USERNAME/awx-mcp-server.git
✅ Portable across all MCP-compatible tools
✅ 18+ AWX operations (templates, jobs, projects, inventories)

Best For: AI-powered automation, natural language AWX control, any MCP client

Optional: VS Code Extension (UI Enhancement)

Optional UI features for VS Code users

Use Case: VS Code users who want additional UI (sidebar views, tree providers)

Features:

✅ Sidebar with AWX instances, jobs, metrics
✅ Tree view of AWX resources
✅ Configuration webview
✅ Auto-configures MCP (or respects manual setup)

Best For: VS Code users wanting rich UI alongside MCP functionality

🚀 Quick Start

Installation Methods

You have three ways to install and run the AWX MCP Server:

Method	Best For	Installation
📦 PyPI (pip)	Quick install, production use	`pip install awx-mcp-server`
🔧 From Source	Customization, development, enterprise forks	Clone from GitHub, edit code
🐳 Docker	Containerized deployment, teams	`docker run surgexlabs/awx-mcp-server`

→ For customization and running from your own repository, see INSTALL_FROM_SOURCE.md

Option 1: PyPI Installation (Recommended for Quick Start)

Install from PyPI

# Install the MCP server
pip install awx-mcp-server

# Verify installation
python -m awx_mcp_server --version

Configure for VS Code

Edit VS Code settings.json (Ctrl+, → Search “chat.mcp”):

{
  "mcpServers": {
    "awx": {
      "command": "python",
      "args": ["-m", "awx_mcp_server"],
      "env": {

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "awx": {
      "command": "python",
      "args": ["-m", "awx_mcp_server"],
      "env": {
        "AWX_BASE_URL": "https://your-awx.com"
      },
      "secrets": {
        "AWX_TOKEN": "your-awx-token"
      }
    }
  }
}