Awx Mcp Server

io.github.SurgeX-Labs由 GitHub 帳號 SurgeX-Labs 發布v1.1.2更新於 Oct 24, 2026

Control AWX/Ansible Tower through natural language - 49 tools for automation

已驗證STDIO僅桌面雲端與基礎設施開發者工具

服務詳細資訊

識別碼: io.github.SurgeX-Labs/awx-mcp-server
傳輸: STDIO
執行環境: Desktop only
信任: Verified
發布於: Sep 16, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此條目所屬的 GitHub 帳號 SurgeX-Labs。這並不表明該帳號就是產品方。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.SurgeX-Labs%2Fawx-mcp-server.svg)](https://sourceweft.com/mcp/io.github.SurgeX-Labs%2Fawx-mcp-server?utm_source=readme&utm_medium=badge)

概覽

AI 產生的概覽

讓 AI 助理用自然語言管理 AWX、Ansible Automation Platform 與 Ansible Tower，包括啟動作業與監控作業。

可以做什麼: 將 MCP 用戶端連接到 AWX/AAP/Tower 執行個體，提供作業範本、作業、專案與清單相關操作。助理可以列出與檢視範本、啟動或取消作業、讀取作業輸出與事件、從 SCM 更新專案，以及列出清單。也支援列出環境與測試連線。
適用情境: 當你希望 AI 助理在對話中驅動 AWX 自動化時使用，例如列出範本、啟動部署作業，或查看作業狀態與日誌，而不必切換到 AWX 網頁介面。
執行需求: 以本機 Python 套件執行（需要 Python 3.10+）。需要設定 AWX_BASE_URL，並提供 AWX_TOKEN，或 AWX_USERNAME 與 AWX_PASSWORD；自簽憑證可將 AWX_VERIFY_SSL 設為 false。需要能連線到 AWX 執行個體的網路。

安裝前請注意

此伺服器持有可控制自動化基礎設施的 AWX 認證（AWX_TOKEN 或 AWX_PASSWORD）。它可以啟用與取消作業、更新專案，會變更真實系統。建議使用權限受限的權杖，並謹慎設定 AWX_VERIFY_SSL=false。

安裝

在 SourceWeft 中

開啟儀表板中的 Awx Mcp Server，將其新增到工作區。
為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照儲存庫中的啟動說明。

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

[MCP Server]

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)

[VS Code Extension]

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

bash

# Install the MCP serverpip install awx-mcp-server
# Verify installationpython -m awx_mcp_server --version

# Install the MCP serverpip install awx-mcp-server
# Verify installationpython -m awx_mcp_server --version

Configure for VS Code

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

json

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

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

Restart VS Code and the MCP server will be available in Copilot Chat.

Option 2: Install from Source (For Customization)

Perfect for: Forking, customization, enterprise deployments, contributing

Quick install:

bash

# Clone the repository (or your fork)git clone https://github.com/SurgeX-Labs/awx-mcp-server.gitcd awx-mcp-server/awx-mcp-python/server
# Create virtual environmentpython -m venv venvsource venv/bin/activate  # Windows: .\venv\Scripts\Activate.ps1
# Install in editable modepip install -e .
# Verifypython -m awx_mcp_server --version

# Clone the repository (or your fork)git clone https://github.com/SurgeX-Labs/awx-mcp-server.gitcd awx-mcp-server/awx-mcp-python/server
# Create virtual environmentpython -m venv venvsource venv/bin/activate  # Windows: .\venv\Scripts\Activate.ps1
# Install in editable modepip install -e .
# Verifypython -m awx_mcp_server --version

VS Code configuration (use venv Python):

json

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

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

📖 Full Guide: See INSTALL_FROM_SOURCE.md for:

Forking the repository
Making customizations to the code
Running from your own fork/repository
Building custom Docker images from source
Enterprise deployment and CI/CD

Option 3: Remote Server Mode (Team/Enterprise)

Prerequisites

Python 3.10+
AWX/Ansible Tower instance
(Optional) Docker or Kubernetes

Quick Start with Docker

bash

cd awx-mcp-python/server
# Start server with monitoring stackdocker-compose up -d
# Server available at:# - API: http://localhost:8000# - Docs: http://localhost:8000/docs# - Metrics: http://localhost:8000/prometheus-metrics# - Prometheus: http://localhost:9090# - Grafana: http://localhost:3000

cd awx-mcp-python/server
# Start server with monitoring stackdocker-compose up -d
# Server available at:# - API: http://localhost:8000# - Docs: http://localhost:8000/docs# - Metrics: http://localhost:8000/prometheus-metrics# - Prometheus: http://localhost:9090# - Grafana: http://localhost:3000

Quick Start with Python

bash

cd awx-mcp-python/server
# Installpip install -e .
# Configure AWX environment (interactive)awx-mcp-server env list
# Start serverawx-mcp-server start --host 0.0.0.0 --port 8000

cd awx-mcp-python/server
# Installpip install -e .
# Configure AWX environment (interactive)awx-mcp-server env list
# Start serverawx-mcp-server start --host 0.0.0.0 --port 8000

CLI Usage

bash

# List job templatesawx-mcp-server templates list
# Launch jobawx-mcp-server jobs launch "Deploy App" --extra-vars '{"env":"prod"}'
# Monitor jobawx-mcp-server jobs get 123awx-mcp-server jobs stdout 123
# Manage projectsawx-mcp-server projects listawx-mcp-server projects update "My Project"
# List inventoriesawx-mcp-server inventories list

# List job templatesawx-mcp-server templates list
# Launch jobawx-mcp-server jobs launch "Deploy App" --extra-vars '{"env":"prod"}'
# Monitor jobawx-mcp-server jobs get 123awx-mcp-server jobs stdout 123
# Manage projectsawx-mcp-server projects listawx-mcp-server projects update "My Project"
# List inventoriesawx-mcp-server inventories list

REST API Usage

bash

# Create API key (first time)curl -X POST http://localhost:8000/api/keys \  -H "Content-Type: application/json" \  -d '{"name": "chatbot", "tenant_id": "team1", "expires_days": 90}'
# List job templatescurl http://localhost:8000/api/v1/job-templates \  -H "X-API-Key: awx_mcp_xxxxx"
# Launch jobcurl -X POST http://localhost:8000/api/v1/jobs/launch \  -H "X-API-Key: awx_mcp_xxxxx" \  -H "Content-Type: application/json" \  -d '{"template_name": "Deploy App", "extra_vars": {"env": "prod"}}'
# Get job statuscurl http://localhost:8000/api/v1/jobs/123 \  -H "X-API-Key: awx_mcp_xxxxx"
# Get job outputcurl http://localhost:8000/api/v1/jobs/123/stdout \  -H "X-API-Key: awx_mcp_xxxxx"

# Create API key (first time)curl -X POST http://localhost:8000/api/keys \  -H "Content-Type: application/json" \  -d '{"name": "chatbot", "tenant_id": "team1", "expires_days": 90}'
# List job templatescurl http://localhost:8000/api/v1/job-templates \  -H "X-API-Key: awx_mcp_xxxxx"
# Launch jobcurl -X POST http://localhost:8000/api/v1/jobs/launch \  -H "X-API-Key: awx_mcp_xxxxx" \  -H "Content-Type: application/json" \  -d '{"template_name": "Deploy App", "extra_vars": {"env": "prod"}}'
# Get job statuscurl http://localhost:8000/api/v1/jobs/123 \  -H "X-API-Key: awx_mcp_xxxxx"
# Get job outputcurl http://localhost:8000/api/v1/jobs/123/stdout \  -H "X-API-Key: awx_mcp_xxxxx"

Kubernetes Deployment

bash

cd server/deployment/helm
helm install awx-mcp-server . \  --set replicaCount=3 \  --set autoscaling.enabled=true \  --set taskPods.enabled=true

cd server/deployment/helm
helm install awx-mcp-server . \  --set replicaCount=3 \  --set autoscaling.enabled=true \  --set taskPods.enabled=true

See: server/README.md for detailed guide

🎨 Integration Examples

Integrate with Custom Chatbot

python

import httpx
class AWXChatbot:    def __init__(self, api_key: str, base_url: str = "http://localhost:8000"):        self.api_key = api_key        self.base_url = base_url        self.headers = {"X-API-Key": api_key}        async def handle_message(self, user_message: str):        """Process user message and call AWX API"""        if "list templates" in user_message.lower():            return await self.list_templates()        elif "launch" in user_message.lower():            template_name = self.extract_template_name(user_message)            return await self.launch_job(template_name)        elif "job status" in user_message.lower():            job_id = self.extract_job_id(user_message)            return await self.get_job(job_id)        async def list_templates(self):        async with httpx.AsyncClient() as client:            response = await client.get(                f"{self.base_url}/api/v1/job-templates",                headers=self.headers            )            return response.json()        async def launch_job(self, template_name: str, extra_vars: dict = None):        async with httpx.AsyncClient() as client:            response = await client.post(                f"{self.base_url}/api/v1/jobs/launch",                headers=self.headers,                json={"template_name": template_name, "extra_vars": extra_vars}            )            return response.json()        async def get_job(self, job_id: int):        async with httpx.AsyncClient() as client:            response = await client.get(                f"{self.base_url}/api/v1/jobs/{job_id}",                headers=self.headers            )            return response.json()
# Usagechatbot = AWXChatbot(api_key="awx_mcp_xxxxx")response = await chatbot.handle_message("list all job templates")

import httpx
class AWXChatbot:    def __init__(self, api_key: str, base_url: str = "http://localhost:8000"):        self.api_key = api_key        self.base_url = base_url        self.headers = {"X-API-Key": api_key}        async def handle_message(self, user_message: str):        """Process user message and call AWX API"""        if "list templates" in user_message.lower():            return await self.list_templates()        elif "launch" in user_message.lower():            template_name = self.extract_template_name(user_message)            return await self.launch_job(template_name)        elif "job status" in user_message.lower():            job_id = self.extract_job_id(user_message)            return await self.get_job(job_id)        async def list_templates(self):        async with httpx.AsyncClient() as client:            response = await client.get(                f"{self.base_url}/api/v1/job-templates",                headers=self.headers            )            return response.json()        async def launch_job(self, template_name: str, extra_vars: dict = None):        async with httpx.AsyncClient() as client:            response = await client.post(                f"{self.base_url}/api/v1/jobs/launch",                headers=self.headers,                json={"template_name": template_name, "extra_vars": extra_vars}            )            return response.json()        async def get_job(self, job_id: int):        async with httpx.AsyncClient() as client:            response = await client.get(                f"{self.base_url}/api/v1/jobs/{job_id}",                headers=self.headers            )            return response.json()
# Usagechatbot = AWXChatbot(api_key="awx_mcp_xxxxx")response = await chatbot.handle_message("list all job templates")

Integrate with Slack Bot

python

from slack_bolt.async_app import AsyncAppimport httpx
app = AsyncApp(token="xoxb-your-token")awx_api_key = "awx_mcp_xxxxx"awx_base_url = "http://localhost:8000"
@app.message("awx")async def handle_awx_command(message, say):    text = message['text']        if "launch" in text:        # Extract template name from message        template = extract_template(text)                # Call AWX API        async with httpx.AsyncClient() as client:            response = await client.post(                f"{awx_base_url}/api/v1/jobs/launch",                headers={"X-API-Key": awx_api_key},                json={"template_name": template}            )            job = response.json()                await say(f"✅ Job launched! ID: {job['id']}, Status: {job['status']}")

from slack_bolt.async_app import AsyncAppimport httpx
app = AsyncApp(token="xoxb-your-token")awx_api_key = "awx_mcp_xxxxx"awx_base_url = "http://localhost:8000"
@app.message("awx")async def handle_awx_command(message, say):    text = message['text']        if "launch" in text:        # Extract template name from message        template = extract_template(text)                # Call AWX API        async with httpx.AsyncClient() as client:            response = await client.post(                f"{awx_base_url}/api/v1/jobs/launch",                headers={"X-API-Key": awx_api_key},                json={"template_name": template}            )            job = response.json()                await say(f"✅ Job launched! ID: {job['id']}, Status: {job['status']}")

🔧 Available AWX Operations

Both VS Code extension and web server support all 16 operations:

Environment Management

env_list - List all configured AWX environments
env_test - Test connection to AWX environment
env_get_active - Get currently active environment

Job Templates

list_job_templates - List all job templates (with filtering)
get_job_template - Get template details by name/ID

Jobs

list_jobs - List all jobs (filter by status, date)
get_job - Get job details by ID
job_launch - Launch job from template
job_cancel - Cancel running job
job_stdout - Get job output/logs
job_events - Get job events (playbook tasks)

Projects

list_projects - List all projects
project_update - Update project from SCM

Inventories

list_inventories - List all inventories
get_inventory - Get inventory details

📦 Project Structure

awx-mcp-python/├── vscode-extension/          # VS Code extension with GitHub Copilot│   ├── src/                   # Extension TypeScript source│   ├── package.json           # Extension manifest│   ├── README.md              # Extension guide│   └── CHANGELOG.md││├── server/                    # Standalone web server│   ├── src/awx_mcp_server/│   │   ├── cli.py             # CLI commands (468 lines)│   │   ├── http_server.py     # FastAPI REST API│   │   ├── mcp_server.py      # MCP server integration│   │   ├── monitoring.py      # Prometheus metrics│   │   ├── task_pods.py       # Kubernetes task pods│   │   ├── clients/           # AWX clients (self-contained)│   │   ├── storage/           # Config & credentials│   │   └── domain/            # Models & exceptions│   ├── deployment/│   │   ├── docker-compose.yml # Docker Compose stack│   │   ├── Dockerfile         # Container image│   │   └── helm/              # Kubernetes Helm chart│   ├── pyproject.toml│   └── README.md│└── tests/                     # Shared test suite    ├── test_*.py    └── conftest.py

awx-mcp-python/├── vscode-extension/          # VS Code extension with GitHub Copilot│   ├── src/                   # Extension TypeScript source│   ├── package.json           # Extension manifest│   ├── README.md              # Extension guide│   └── CHANGELOG.md││├── server/                    # Standalone web server│   ├── src/awx_mcp_server/│   │   ├── cli.py             # CLI commands (468 lines)│   │   ├── http_server.py     # FastAPI REST API│   │   ├── mcp_server.py      # MCP server integration│   │   ├── monitoring.py      # Prometheus metrics│   │   ├── task_pods.py       # Kubernetes task pods│   │   ├── clients/           # AWX clients (self-contained)│   │   ├── storage/           # Config & credentials│   │   └── domain/            # Models & exceptions│   ├── deployment/│   │   ├── docker-compose.yml # Docker Compose stack│   │   ├── Dockerfile         # Container image│   │   └── helm/              # Kubernetes Helm chart│   ├── pyproject.toml│   └── README.md│└── tests/                     # Shared test suite    ├── test_*.py    └── conftest.py

🏗️ Architecture

VS Code Extension Architecture

┌─────────────────┐│   VS Code IDE   ││                 ││  ┌───────────┐  │     stdio      ┌──────────────┐│  │  GitHub   │──┼────transport───▶│  MCP Server  ││  │  Copilot  │  │    (local)     │   (shared)   ││  │   Chat    │◀─┼────────────────│   16 Tools   ││  └───────────┘  │                └──────────────┘│                 │                        ││  ┌───────────┐  │                        ││  │ @awx Chat │  │                        ││  │Participant│  │                        ▼│  └───────────┘  │                 ┌──────────────┐└─────────────────┘                 │     AWX      │                                    │   Instance   │                                    └──────────────┘

┌─────────────────┐│   VS Code IDE   ││                 ││  ┌───────────┐  │     stdio      ┌──────────────┐│  │  GitHub   │──┼────transport───▶│  MCP Server  ││  │  Copilot  │  │    (local)     │   (shared)   ││  │   Chat    │◀─┼────────────────│   16 Tools   ││  └───────────┘  │                └──────────────┘│                 │                        ││  ┌───────────┐  │                        ││  │ @awx Chat │  │                        ││  │Participant│  │                        ▼│  └───────────┘  │                 ┌──────────────┐└─────────────────┘                 │     AWX      │                                    │   Instance   │                                    └──────────────┘

Flow:

User types @awx list templates in Copilot Chat
Extension sends MCP request to local server via stdio
MCP server calls AWX REST API
Results returned to Copilot Chat
AI formats response naturally

Web Server Architecture

┌──────────────┐      REST API       ┌──────────────┐│   Chatbot    │────────────────────▶│  FastAPI     ││  /Custom App │   (HTTP/JSON)       │   Server     │└──────────────┘                     └──────────────┘                                            │┌──────────────┐      REST API       ││   Slack Bot  │────────────────────▶│└──────────────┘                     │                                     │┌──────────────┐         CLI         ││   Terminal   │────────────────────▶││   Scripts    │   (commands)        │└──────────────┘                     │                                     │                              ┌──────┴───────┐                              │              │                              │   Clients    │                              │  REST + CLI  │                              │              │                              └──────┬───────┘                                     │                                     ▼                              ┌──────────────┐                              │     AWX      │                              │   Instance   │                              └──────────────┘

┌──────────────┐      REST API       ┌──────────────┐│   Chatbot    │────────────────────▶│  FastAPI     ││  /Custom App │   (HTTP/JSON)       │   Server     │└──────────────┘                     └──────────────┘                                            │┌──────────────┐      REST API       ││   Slack Bot  │────────────────────▶│└──────────────┘                     │                                     │┌──────────────┐         CLI         ││   Terminal   │────────────────────▶││   Scripts    │   (commands)        │└──────────────┘                     │                                     │                              ┌──────┴───────┐                              │              │                              │   Clients    │                              │  REST + CLI  │                              │              │                              └──────┬───────┘                                     │                                     ▼                              ┌──────────────┐                              │     AWX      │                              │   Instance   │                              └──────────────┘

Flow:

Client (chatbot/CLI) sends HTTP request with API key
FastAPI server authenticates request
Server calls AWX API via composite client
Results returned as JSON
Client formats for end user (Slack, terminal, etc.)

🔒 Security

VS Code Extension

Credentials stored in VS Code secure storage
Local server only (no network exposure)
Environment-based isolation

Web Server

API key authentication (SHA-256 hashed)
Multi-tenant isolation
Configurable key expiration
HTTPS recommended for production
Environment variables for secrets

🚢 Deployment Options

For VS Code Extension

Install extension from .vsix file
MCP server runs automatically when VS Code starts
No additional infrastructure needed

For Web Server

Development

Production - Docker

Includes: Server, Prometheus, Grafana

Production - Kubernetes

bash

cd server/deployment/helmhelm install awx-mcp-server . \  --set autoscaling.enabled=true \  --set taskPods.enabled=true \  --set ingress.enabled=true

cd server/deployment/helmhelm install awx-mcp-server . \  --set autoscaling.enabled=true \  --set taskPods.enabled=true \  --set ingress.enabled=true

Features:

Horizontal Pod Autoscaling (HPA)
Task pods (ephemeral Job per operation)
Prometheus monitoring
Ingress support

🛠️ Development

Prerequisites

Python 3.10+
Node.js 18+ (for VS Code extension)
Docker (optional)
Kubernetes cluster (optional)

Setup Development Environment

bash

# Clone repositorygit clone https://github.com/your-org/awx-mcp.gitcd awx-mcp/awx-mcp-python
# Install shared package (for VS Code extension)cd sharedpip install -e ".[dev]"
# Install servercd ../serverpip install -e ".[dev]"
# Install extension dependenciescd ../vscode-extensionnpm install
# Run testscd ../testspytest -v

# Clone repositorygit clone https://github.com/your-org/awx-mcp.gitcd awx-mcp/awx-mcp-python
# Install shared package (for VS Code extension)cd sharedpip install -e ".[dev]"
# Install servercd ../serverpip install -e ".[dev]"
# Install extension dependenciescd ../vscode-extensionnpm install
# Run testscd ../testspytest -v

Running Tests

bash

# Server testscd serverpytest tests/ -v --cov
# Integration testscd testspytest test_mcp_integration.py -v

# Server testscd serverpytest tests/ -v --cov
# Integration testscd testspytest test_mcp_integration.py -v

Building VS Code Extension

📊 Monitoring (Web Server)

Access monitoring dashboards:

Prometheus: http://localhost:9090
Grafana: http://localhost:3000 (admin/admin)
Metrics Endpoint: http://localhost:8000/prometheus-metrics

Available Metrics

awx_mcp_requests_total - Total requests by tenant/endpoint
awx_mcp_request_duration_seconds - Request latency
awx_mcp_active_connections - Active connections per tenant
awx_mcp_tool_calls_total - MCP tool invocations
awx_mcp_errors_total - Error count by type

📚 Documentation

Installation & Setup

Install from PyPI - Quick install with pip install awx-mcp-server
Install from Source - Fork, customize, and run from your own repository
OS Compatibility - Windows, macOS, and Linux installation and configuration

Platform Support

AAP Support Guide - Complete guide for Ansible Automation Platform, AWX, and Ansible Tower

Deployment Architectures

Deployment Architecture - Single-user vs Team/Enterprise deployment options
Remote Deployment Guide - Docker, Kubernetes, and cloud deployment
Dual-Mode Quick Start - Quick reference for choosing deployment mode

Advanced Features (Planned)

Vault Integration - HashiCorp Vault, AWS Secrets Manager, Azure Key Vault support (v2.0.0)
Implementation Status - Current features and roadmap

Additional Resources

MCP Copilot Setup - VS Code MCP configuration
Quick Reference - Common commands and examples
AWX MCP Query Reference - Natural language query examples

🤝 Contributing

We welcome contributions! Please:

Fork the repository
Create a feature branch
Make your changes with tests
Submit a pull request

Code Style

Python: Follow PEP 8, use type hints
TypeScript: Follow ESLint rules
Write tests for new features
Update documentation

📄 License

MIT License - see LICENSE file

🆘 Support

Issues: https://github.com/your-org/awx-mcp/issues
Discussions: https://github.com/your-org/awx-mcp/discussions
Documentation: See README files in subdirectories

🎉 Quick Reference

VS Code Extension Commands

Ctrl+Shift+P → AWX: Configure Environment
Ctrl+Shift+P → AWX: Test Connection
Ctrl+Shift+P → AWX: Switch Environment
In Copilot Chat: @awx <your command>

Web Server CLI Commands

bash

awx-mcp-server start                    # Start HTTP serverawx-mcp-server env list                 # List environmentsawx-mcp-server templates list           # List templatesawx-mcp-server jobs launch "Template"   # Launch jobawx-mcp-server jobs get 123             # Get job detailsawx-mcp-server projects list            # List projectsawx-mcp-server inventories list         # List inventories

awx-mcp-server start                    # Start HTTP serverawx-mcp-server env list                 # List environmentsawx-mcp-server templates list           # List templatesawx-mcp-server jobs launch "Template"   # Launch jobawx-mcp-server jobs get 123             # Get job detailsawx-mcp-server projects list            # List projectsawx-mcp-server inventories list         # List inventories

Web Server API Endpoints

POST   /api/keys                         # Create API keyGET    /api/v1/environments              # List environmentsGET    /api/v1/job-templates             # List templatesPOST   /api/v1/jobs/launch               # Launch jobGET    /api/v1/jobs/{id}                 # Get jobGET    /api/v1/jobs/{id}/stdout          # Get outputGET    /api/v1/projects                  # List projectsGET    /api/v1/inventories               # List inventoriesGET    /health                           # Health checkGET    /prometheus-metrics               # MetricsGET    /docs                             # API documentation

POST   /api/keys                         # Create API keyGET    /api/v1/environments              # List environmentsGET    /api/v1/job-templates             # List templatesPOST   /api/v1/jobs/launch               # Launch jobGET    /api/v1/jobs/{id}                 # Get jobGET    /api/v1/jobs/{id}/stdout          # Get outputGET    /api/v1/projects                  # List projectsGET    /api/v1/inventories               # List inventoriesGET    /health                           # Health checkGET    /prometheus-metrics               # MetricsGET    /docs                             # API documentation

Made with ❤️ for AWX automation and AI integration

來源：README.md，提交 4087087

工具

SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

v1.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。
已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。
已列出工具15 分
請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。
描述必需15 分
圖示10 分
文件15 分
授權條款10 分
請在儲存庫或註冊中心條目中宣告授權條款。