Ansible MCP Collection

This collection includes a variety of Ansible content to help automate interactions with Model Context Protocol (MCP) servers. This collection is maintained by the Ansible Cloud Content team.

Contents

• Ansible MCP Collection
• Contents
• Description
• Requirements
  • Ansible version compatibility
  • Python version compatibility
  • Collection dependencies
  • External requirements
• Included content
  • Connection Plugins
  • Modules
• Testing
• Installation
• Support
• Release notes
• More information
• License Information

Description

This collection enables Ansible users to interact with MCP servers through automation. MCP is a standardized protocol for communication between AI systems and external tools or data sources.

The collection provides modules to query server information, discover available tools, and execute tool calls on MCP servers within Ansible playbooks and Execution Environments.

Requirements

Ansible version compatibility

This collection has been tested against the following Ansible versions: >=2.16.0.

Plugins and modules within a collection may be tested with only specific Ansible versions. A collection may contain metadata that identifies these versions. PEP440 is the schema used to describe the versions of Ansible.

Python version compatibility

This collection requires Python 3.10 or greater.

Collection dependencies

This collection depends on the following collections: - ansible.utils

External requirements

Some modules and plugins require external libraries. Please check the requirements for each plugin or module you use in the documentation to find out which requirements are needed.

Included content

Connection plugins

Modules

Testing

This collection is tested using GitHub Actions. To learn more about testing, refer to CI.md.

Installation

    ansible-galaxy collection install ansible.mcp

You can also include it in a requirements.yml file and install it via ansible-galaxy collection install -r requirements.yml using the format:

collections:
  - name: ansible.mcp

To upgrade the collection to the latest available version, run the following command:

ansible-galaxy collection install ansible.mcp --upgrade

You can also install a specific version of the collection, for example, if you need to downgrade when something is broken in the latest version (please report an issue in this repository). Use the following syntax where X.Y.Z can be any available version:

ansible-galaxy collection install ansible.mcp:==X.Y.Z

See Ansible Using Collections for more details.

Support

For support and questions about this collection:

• Issues: Report bugs or request features via GitHub Issues
• Community Help: Available on the Ansible Forum
• Discussions: Join the Ansible collection development forum

Release notes

See the changelog.

More information

• MCP Documentation
• Ansible Collection overview
• Ansible collection development forum
• Ansible User guide
• Ansible Developer guide
• Ansible Collections Checklist
• Ansible Community code of conduct
• The Bullhorn (the Ansible Contributor newsletter)
• News for Maintainers

License Information

GNU General Public License v3.0 or later.

See LICENSE to see the full text.