Ansible MCP Server

@washyu

Repository

Basic information

About Ansible MCP Server

Ansible MCP Server for intelligent infrastructure management

#mcp#ansible#infrastructure-management

Ansible MCP Server config

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

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

Ansible MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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.

Frequently asked questions

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.

Comments

More Other MCP servers

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code