Ansible MCP Server

Name: Ansible MCP Server
Author: washyu

@washyu

Repository

About Ansible MCP Server

Ansible MCP Server for intelligent infrastructure management

#mcp #ansible #infrastructure-management

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp_python_server": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.