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

This collection is maintained by Red Hat.

As Red Hat Ansible Certified Content, this collection is entitled to support through Ansible Automation Platform (AAP) using the Create issue button on the top right corner. If a support case cannot be opened with Red Hat and the collection has been obtained either from Galaxy or GitHub, there may be community help available on the Ansible Forum.

For additional support and questions about this collection, please see:

• Issues: Report bugs or request features via GitHub Issues
• 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.