Awx MCP सर्वर | PlugMCP
सामग्री पर जाएँ 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.
Control AWX/Ansible Tower through natural language - 49 tools for automation
किसी भी टूल को किसी भी एजेंट से जोड़ें। उन लोगों के लिए MCP निर्देशिका जो सर्वर नहीं लिखते।
उत्पाद
निर्देशिका
डेवलपर्स
कंपनी
API keyAWX_BASE_URL, AWX_TOKEN, AWX_USERNAME, AWX_PASSWORD, AWX_VERIFY_SSL 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
✅ 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)
✅ 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:
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": {
"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
# Clone the repository (or your fork)
git clone https://github.com/SurgeX-Labs/awx-mcp-server.git
cd awx-mcp-server/awx-mcp-python/server
# Create virtual environment
python -m venv venv
source venv/bin/activate # Windows: .\venv\Scripts\Activate.ps1
# Install in editable mode
pip install -e .
# Verify
python -m awx_mcp_server --version
VS Code configuration (use venv Python):
{
"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"
}
}
}
}
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 cd awx-mcp-python/server
# Start server with monitoring stack
docker-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 cd awx-mcp-python/server
# Install
pip install -e .
# Configure AWX environment (interactive)
awx-mcp-server env list
# Start server
awx-mcp-server start --host 0.0.0.0 --port 8000
CLI Usage # List job templates
awx-mcp-server templates list
# Launch job
awx-mcp-server jobs launch "Deploy App" --extra-vars '{"env":"prod"}'
# Monitor job
awx-mcp-server jobs get 123
awx-mcp-server jobs stdout 123
# Manage projects
awx-mcp-server projects list
awx-mcp-server projects update "My Project"
# List inventories
awx-mcp-server inventories list
REST API Usage # 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 templates
curl http://localhost:8000/api/v1/job-templates \
-H "X-API-Key: awx_mcp_xxxxx"
# Launch job
curl -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 status
curl http://localhost:8000/api/v1/jobs/123 \
-H "X-API-Key: awx_mcp_xxxxx"
# Get job output
curl http://localhost:8000/api/v1/jobs/123/stdout \
-H "X-API-Key: awx_mcp_xxxxx"
Kubernetes Deployment cd server/deployment/helm
helm install awx-mcp-server . \
--set replicaCount=3 \
--set autoscaling.enabled=true \
--set taskPods.enabled=true
🎨 Integration Examples
Integrate with Custom Chatbot 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()
# Usage
chatbot = AWXChatbot(api_key="awx_mcp_xxxxx")
response = await chatbot.handle_message("list all job templates")
Integrate with Slack Bot from slack_bolt.async_app import AsyncApp
import 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
🏗️ Architecture
VS Code Extension Architecture ┌─────────────────┐
│ VS Code IDE │
│ │
│ ┌───────────┐ │ stdio ┌──────────────┐
│ │ GitHub │──┼────transport───▶│ MCP Server │
│ │ Copilot │ │ (local) │ (shared) │
│ │ Chat │◀─┼────────────────│ 16 Tools │
│ └───────────┘ │ └──────────────┘
│ │ │
│ ┌───────────┐ │ │
│ │ @awx Chat │ │ │
│ │Participant│ │ ▼
│ └───────────┘ │ ┌──────────────┐
└─────────────────┘ │ AWX │
│ Instance │
└──────────────┘
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 │
└──────────────┘
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 cd server
pip install -e .
awx-mcp-server start
Production - Docker cd server
docker-compose up -d
Includes: Server, Prometheus, Grafana
Production - Kubernetes cd server/deployment/helm
helm install awx-mcp-server . \
--set autoscaling.enabled=true \
--set taskPods.enabled=true \
--set ingress.enabled=true
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 # Clone repository
git clone https://github.com/your-org/awx-mcp.git
cd awx-mcp/awx-mcp-python
# Install shared package (for VS Code extension)
cd shared
pip install -e ".[dev]"
# Install server
cd ../server
pip install -e ".[dev]"
# Install extension dependencies
cd ../vscode-extension
npm install
# Run tests
cd ../tests
pytest -v
Running Tests # Server tests
cd server
pytest tests/ -v --cov
# Integration tests
cd tests
pytest test_mcp_integration.py -v
Building VS Code Extension cd vscode-extension
npm run package
# Generates awx-mcp-*.vsix file
📊 Monitoring (Web Server) Access monitoring dashboards:
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
Platform Support
AAP Support Guide - Complete guide for Ansible Automation Platform, AWX, and Ansible Tower
Deployment Architectures
Advanced Features (Planned)
Additional Resources
🤝 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
🆘 Support
🎉 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 awx-mcp-server start # Start HTTP server
awx-mcp-server env list # List environments
awx-mcp-server templates list # List templates
awx-mcp-server jobs launch "Template" # Launch job
awx-mcp-server jobs get 123 # Get job details
awx-mcp-server projects list # List projects
awx-mcp-server inventories list # List inventories
Web Server API Endpoints POST /api/keys # Create API key
GET /api/v1/environments # List environments
GET /api/v1/job-templates # List templates
POST /api/v1/jobs/launch # Launch job
GET /api/v1/jobs/{id} # Get job
GET /api/v1/jobs/{id}/stdout # Get output
GET /api/v1/projects # List projects
GET /api/v1/inventories # List inventories
GET /health # Health check
GET /prometheus-metrics # Metrics
GET /docs # API documentation
Made with ❤️ for AWX automation and AI integration
डायरेक्टरी स्कोर 20/100 सूचीबद्ध 10 में से 10
आधिकारिक MCP Registry में 18 में से 18
मेंटेनर द्वारा क्लेम किया गया 8 में से 0
टूल सूची के साथ जवाब देता है 12 में से 0
GitHub स्टार 16 में से 0
साप्ताहिक डाउनलोड 10 में से 0
Ohmyzsh 🙃 A delightful community-driven (with 2,500+ contributors) framework for managing your zsh configuration. Includes 300+ optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python Ruflo 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, feder TrendRadar ⭐AI-driven public opinion & trend monitor with multi-platform aggregation, RSS, and smart alerts.🎯 告别信息过载,你的 AI 舆情监控助手与热点筛选工具!聚合多平台热点 + RSS 订阅,支持关键词精准筛选。AI 智能筛选新闻 + AI 翻译 + AI 分析简报直推手机,也支持接入 MCP 架构 Dbx 25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Dock Docker Android Android in docker solution with noVNC supported, video recording, mcp server and AI-agent TREK The most complete open-source travel planner: real-time collaboration, bookings, budgets, packing lists, journals, offline PWA, SSO and an AI-ready MCP server, with planet-wide place search and routin Pansou PanSou是一款高性能的网盘资源搜索API服务,支持TG频道和插件搜索。系统设计以性能和可扩展性为核心,支持多频道多插件并发搜索、结果智能排序和网盘类型分类。docker集成前后端,一键启动,开箱即用。仅供学习研究,请勿以各种形式用于盈利目的。 https://t.me/s/webhtv XHS Downloader 小红书(XiaoHongShu、RedNote)链接提取/作品采集工具 Nginx Ui Yet another WebUI for Nginx Tyk Open Source API and AI Gateway supporting REST, GraphQL, TCP, gRPC and MCP (Model Context Protocol) Openstatus Open-source status page, incident response and uptime monitoring Dashboard Icons 3,400+ curated icons and logos for dashboards and AI agents. SVG, PNG and WEBP on a free CDN, plus an MCP server for Claude Code, Codex, ChatGPT, Cursor, Hermes and OpenClaw. DevOps MCP सर्वर सबसे अच्छे DevOps MCP सर्वर azure-compute Azure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compare VM pricing, VMSS, scale set, autoscale, burstable, lightweight server, website, backend, GPU, machine l self-hosted-funnel-launch Deploy a self-hosted funnel builder, take a funnel from empty install to published - landing page, checkout, one-click upsell, thank-you - and drive it from an agent over MCP. Covers deploying to Clou
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
Awx कैसे इंस्टॉल करें? इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
क्या Awx के लिए API key चाहिए? पब्लिशर ने ये एनवायरनमेंट वेरिएबल बताए हैं: AWX_BASE_URL, AWX_TOKEN, AWX_USERNAME, AWX_PASSWORD, AWX_VERIFY_SSL।
Awx कौन सा ट्रांसपोर्ट इस्तेमाल करता है? Awx stdio पर लोकल चलता है।
Awx की पिछली जाँच कब हुई थी? पिछली जाँच 2026-11-09 को हुई। Control AWX/Ansible Tower through natural language - 49 tools for automation
टूल के विवरण मौजूद हैं 6 में से 0
वॉइस के लिए तैयार 3 में से 0