Ansible MCP Server

Ein Model Context Protocol (MCP)-Server für die Ansible-Automatisierung. Dieser Server ermöglicht KI-Assistenten die Interaktion mit Ansible, die Ausführung von Playbooks, die Bestandsverwaltung und die direkte Ausführung anderer Ansible-Operationen.

Merkmale

Ansible-Playbooks ausführen : Führen Sie Ansible-Playbooks mit Unterstützung für Parameter wie Inventar, zusätzliche Variablen, Tags und Limits aus
Inventar auflisten : Hosts und Gruppen aus einer Ansible-Inventardatei anzeigen
Syntax prüfen : Validieren Sie die Ansible-Playbook-Syntax ohne Ausführung
Aufgaben auflisten : Zeigen Sie eine Vorschau der Aufgaben an, die von einem Playbook ausgeführt werden würden
Zugriff auf Standardinventar : Zugriff auf die Standard-Ansible-Inventardatei über die Ressourcen-API

Anforderungen

Node.js 18 oder höher
npm oder yarn
Ansible installiert und im PATH
@modelcontextprotocol/sdk (automatisch installiert)

Installation

1. Klonen Sie das Repository

git clone https://github.com/your-username/mcp-ansible.git
cd mcp-ansible

2. Abhängigkeiten installieren

npm install

3. Erstellen Sie den Server

npm run build

4. MCP-Einstellungen konfigurieren

Fügen Sie den Ansible MCP-Server zu Ihrer MCP-Einstellungskonfigurationsdatei hinzu.

Für VSCode mit Claude-Erweiterung:

Bearbeiten Sie die Datei unter ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Für die Claude Desktop-App:

macOS: Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: Bearbeiten Sie %APPDATA%\Claude\claude_desktop_config.json
Linux: Bearbeiten Sie ~/.config/Claude/claude_desktop_config.json

Fügen Sie dem Abschnitt mcpServers Folgendes hinzu:

{
  "mcpServers": {
    "ansible": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-ansible/build/index.js"],
      "env": {}
    }
  }
}

Stellen Sie sicher, dass Sie /absolute/path/to/mcp-ansible durch den tatsächlichen Pfad zu Ihrer Installation ersetzen.

Anwendungsbeispiele

Nach der Installation und Konfiguration stellt der MCP-Server dem KI-Assistenten die folgenden Tools zur Verfügung:

1. Führen Sie ein Playbook aus

<use_mcp_tool>
<server_name>ansible</server_name>
<tool_name>run_playbook</tool_name>
<arguments>
{
  "playbook": "/path/to/your/playbook.yml",
  "inventory": "/path/to/inventory.ini",
  "extraVars": {
    "var1": "value1",
    "var2": "value2"
  },
  "tags": "setup,configure",
  "limit": "webservers"
}
</arguments>
</use_mcp_tool>

2. Inventar auflisten

<use_mcp_tool>
<server_name>ansible</server_name>
<tool_name>list_inventory</tool_name>
<arguments>
{
  "inventory": "/path/to/inventory.ini"
}
</arguments>
</use_mcp_tool>

3. Überprüfen Sie die Playbook-Syntax

<use_mcp_tool>
<server_name>ansible</server_name>
<tool_name>check_syntax</tool_name>
<arguments>
{
  "playbook": "/path/to/your/playbook.yml"
}
</arguments>
</use_mcp_tool>

4. Aufgaben in einem Playbook auflisten

<use_mcp_tool>
<server_name>ansible</server_name>
<tool_name>list_tasks</tool_name>
<arguments>
{
  "playbook": "/path/to/your/playbook.yml"
}
</arguments>
</use_mcp_tool>

5. Zugriff auf die Standardinventarressource

<access_mcp_resource>
<server_name>ansible</server_name>
<uri>ansible://inventory/default</uri>
</access_mcp_resource>

Entwicklung

Projektstruktur

mcp-ansible/
├── src/
│   ├── index.ts                  # Main entry point
│   └── ansible-mcp-server/       
│       └── index.ts              # Ansible MCP server implementation
├── package.json                  # Project configuration and dependencies
├── tsconfig.json                 # TypeScript configuration
└── README.md                     # Documentation

Neue Funktionen hinzufügen

So fügen Sie dem MCP-Server neue Ansible-Funktionen hinzu:

Ändern Sie src/ansible-mcp-server/index.ts
Fügen Sie Ihr neues Tool in der Methode setupToolHandlers hinzu
Implementieren Sie eine Handlerfunktion für Ihr Tool
Neuaufbau mit npm run build

Lizenz

MIT-Lizenz – Einzelheiten finden Sie unter LIZENZ

Ansible MCP Server

Integrations