Ansible MCP Server

What is Ansible MCP Server?

Ansible MCP Server is a Model Context Protocol (MCP) server for managing homelab infrastructure with Ansible. It integrates with local LLMs via Ollama and supports both WebSocket and stdio transports. Designed for Linux-based homelab environments (Proxmox, Ubuntu, Debian), it is aimed at infrastructure automation and AI-assisted operations.

How to use Ansible MCP Server?

Install dependencies with uv sync or pip install -e ., copy .env.example to .env, and configure settings (e.g., Ollama host and model). Start the server with uv run python main.py (WebSocket default) or use --transport stdio for Claude Desktop compatibility. Test with python simple_test.py or the interactive agent via uv run python -m src.agents.websocket_agent.

Key features of Ansible MCP Server

• Manages homelab infrastructure through Ansible and MCP.
• Supports both WebSocket and stdio transports.
• Integrates with local LLMs via Ollama.
• Linux-first with WSL2 support for Windows.
• Provides an interactive AI agent for testing.
• Currently includes a hello_world tool.

Use cases of Ansible MCP Server

• Automating homelab infrastructure tasks with AI assistance.
• Running Ansible playbooks through a conversational interface.
• Prototyping MCP servers for homelab environments.
• Integrating local LLM agents with infrastructure management tools.

FAQ from Ansible MCP Server

What tools does Ansible MCP Server currently provide?

Currently only the hello_world tool is implemented. Future tools are planned for infrastructure discovery, Ansible playbook execution, template management, SOPs, and security scanning.

What are the prerequisites for running Ansible MCP Server?

You need Python, uv or pip, and an Ollama instance with a local LLM model (e.g., llama3.2:3b). Linux is recommended; Windows users must use WSL2.

How can I run the server in stdio mode for Claude Desktop?

Use uv run python main.py --transport stdio.

Does Ansible MCP Server support Windows natively?

No, it is Linux-first. Windows users should use WSL2 for development.