Skip to content
MCP server

Ansible MCP Server

Read-only Ansible checks for agents: installed module specs, task args, upgrade impact

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.1.5
Listing updated
2 days ago

About Ansible MCP Server

Ansible MCP Server is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Agents often write Ansible tasks from training data that predates the collection version you actually have installed. This server answers from your own checkout instead, using ansible-doc --json against your collections paths, so an option removed in a newer community.general release is flagged before the task is written.

It is read-only by design. The README says it never runs a play or --check, never connects to a managed host and never supplies a vault secret; vault password scripts are replaced with a dummy file and script or plugin inventory sources are off by default. Inventory output is redacted.

It also parses YAML the way Ansible does (YAML 1.1), so unquoted off becomes false and 0755 becomes 493, and it warns when that is probably a bug. A collection-upgrade check downloads only the target version into its own cache and diffs the argument specs of modules your tasks use, ending in a verdict tied to file and line. On Windows it runs Ansible through WSL.

Install

Run in a terminal

claude mcp add ansible-mcp -- npx -y @yawlabs/ansible-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ansible-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/ansible-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ansible-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/ansible-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ansible-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/ansible-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ansible-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/ansible-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ansible-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/ansible-mcp"
      ]
    }
  }
}

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

ansible_project_info
Reports ansible-core version, effective config, collections and roles paths, playbooks, inventories and requirements files.
ansible_module_doc
Returns every option of one module or plugin as installed, with types, choices, aliases, deprecations and collection version.
ansible_module_search
Finds installed modules and plugins by name or description.
ansible_check_task_args
Checks inline task YAML or a tasks file against installed docs for unknown, missing or invalid options.
ansible_role_interface
Reads a role's argument-spec entry points, options, defaults, dependencies and galaxy_info.
ansible_upgrade_impact
Diffs argument specs of modules your tasks use against a target collection version.

What it does

Installed-version specs
Returns every option of a module as installed, including choices, aliases and deprecations.
Task argument checks
Flags unknown, missing or badly typed options in inline YAML or a tasks file.
Role interfaces
Reads argument specs, defaults, dependencies and galaxy_info from a role.
Upgrade impact
Diffs the argument specs your tasks use against a target collection version.
YAML 1.1 awareness
Reads unquoted values the way Ansible does and warns about likely mistakes.
Read-only guarantees
Never runs plays, contacts managed hosts or uses vault secrets.

Good for

  • Check an agent-written task against the modules installed in your checkout
  • See what bumping community.general would break in existing tasks
  • Review a role's inputs and defaults before reusing it
  • Audit inventory and play structure without exposing secrets

Pricing

Open source

MIT licensed; free to use

Prices change. Check yaw.sh before you buy.

Ansible MCP Server FAQ

Does it run my playbooks?

No. It is read-only and never runs a play, never runs --check and never connects to a managed host.

Where do the module specs come from?

From ansible-doc --json run against the collections paths in your checkout, not from upstream docs.

Does it work on Windows?

Yes through WSL, because Ansible has no Windows control node; the server starts it with wsl.exe --exec.

What licence is it under?

MIT, published on npm as @yawlabs/ansible-mcp.

Is Ansible MCP Server free?

Yes. Ansible MCP Server is open source, so you can use and self-host it for free.

How do I add Ansible MCP Server to Claude Code?

Run this command in your terminal: claude mcp add ansible-mcp -- npx -y @yawlabs/ansible-mcp

What are the best alternatives to Ansible MCP Server?

The closest alternatives to Ansible MCP Server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Ansible MCP Server

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools