ansible-devtools-mcp

Standalone, vendor-agnostic MCP server for Ansible workflows with first-class support for modern MCP clients (GitHub Copilot, Claude Code, Cursor).

Requirements

  • Python 3.12+
  • ansible-core 2.20+ (installed automatically as a package dependency)
  • uv recommended for install and execution

One-click setup

Install once:

uv tool install ansible-devtools-mcp

Then configure your client in one command:

GitHub Copilot in VS Code

ansible-devtools-mcp install --client copilot

Claude Code

ansible-devtools-mcp install --client claude

Cursor

ansible-devtools-mcp install --client cursor

For project-scoped setup (checked into your repo):

ansible-devtools-mcp install --client copilot --scope project --workspace-root .
ansible-devtools-mcp install --client cursor --scope project --workspace-root .

Use a custom server key in client config if needed:

ansible-devtools-mcp install --client copilot --name ansible-devtools-mcp-prod

Running the server manually

Default transport (STDIO):

ansible-devtools-mcp serve --stdio

Streamable HTTP transport:

ansible-devtools-mcp serve --http --host 127.0.0.1 --port 8000

SSE transport:

ansible-devtools-mcp serve --sse --host 127.0.0.1 --port 8000

Why ansible-devtools-mcp serve --stdio keeps the terminal open

--stdio runs a long-lived MCP server process. It waits for JSON-RPC messages from your MCP client.

  • This is expected.
  • Press Ctrl+C to stop it when running manually.
  • In real usage, the client launches and manages this process for you.

Tool coverage

Core Ansible operations

  • lint
  • playbook_syntax_check
  • playbook_run
  • inventory_parse
  • inventory_graph

Upstream-compatible endpoints

  • list_available_tools
  • zen_of_ansible
  • ansible_content_best_practices
  • ansible_lint
  • ade_environment_info
  • ade_setup_environment
  • adt_check_env
  • ansible_create_playbook
  • ansible_create_collection
  • define_and_build_execution_env
  • ansible_navigator

Detailed parity notes: ansible://docs/upstream-parity

Typical local development loop

uv run pytest tests/unit -q --tb=short
uv run pytest tests/integration -q --tb=short -m integration

Upstream comparison

Area VS Code Ansible MCP (extension-coupled model) ansible-devtools-mcp
Packaging Coupled to extension/monorepo workflows Standalone Python package (ansible-devtools-mcp)
Client scope Primarily VS Code/Copilot flows Any MCP-compatible client
Transport Usually extension-managed STDIO STDIO, Streamable HTTP, SSE
Tool architecture Extension-shaped integration Plugin router + entry-point extension model
Token behavior Often more verbose metadata payloads Compact tool descriptions and bounded responses
Docs access Mostly extension context MCP resources (ansible://docs/*)

Marketplace compatibility

For Marketplace specifics and how to ship a VS Code wrapper extension around this server, see docs/MARKETPLACE_COMPATIBILITY.md.

Additional docs

License

MIT

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for shatakshiiii from gravatar.com shatakshiiii

Credits

Author: ansible-devtools-mcp maintainers

License expression

MIT
View SPDX License List

Requires

Python >=3.12

Provides Extra

dev

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ansible_devtools_mcp-1.0.1.tar.gz (28.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ansible_devtools_mcp-1.0.1-py3-none-any.whl (35.5 kB view details)

Uploaded Python 3

File details

Details for the file ansible_devtools_mcp-1.0.1.tar.gz.

File metadata

  • Download URL: ansible_devtools_mcp-1.0.1.tar.gz
  • Upload date:
  • Size: 28.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.0

File hashes

Hashes for ansible_devtools_mcp-1.0.1.tar.gz
Algorithm Hash digest
SHA256 82ad3343a08b3e51bbef567bb17249f52a8670cd6e981c2acbd44630fee1bfd7
MD5 919b5082bfa76a52e018e63653e8e91f
BLAKE2b-256 6ec0ed925accb51509bbb1a680bff82c70cd83838db955c94a2955dc7591ab52

See more details on using hashes here.

File details

Details for the file ansible_devtools_mcp-1.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for ansible_devtools_mcp-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8443b75b491fd435e5d23ef276e94133757824d29b99c89ac89f17abddc5a23c
MD5 c7f60734abfb6eefdaf92e12c1891f62
BLAKE2b-256 f74e57c353cb7003066fcef8653fa1e4a97cce283621047f6994dbb9778be4f8

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page