Servidor MCP de Ansible

Un servidor de Protocolo de Contexto de Modelo (MCP) para la automatización de Ansible. Este servidor permite a los asistentes de IA interactuar con Ansible, ejecutar playbooks, gestionar el inventario y realizar otras operaciones de Ansible directamente.

Características

Ejecutar playbooks de Ansible : ejecute playbooks de Ansible con soporte para parámetros como inventario, variables adicionales, etiquetas y límites
Lista de inventario : ver hosts y grupos desde un archivo de inventario de Ansible
Comprobar sintaxis : validar la sintaxis del libro de estrategias de Ansible sin ejecución
Lista de tareas : vista previa de las tareas que se ejecutarían mediante un libro de jugadas
Acceder al inventario predeterminado : acceda al archivo de inventario predeterminado de Ansible a través de la API de recursos

Requisitos

Node.js 18 o superior
npm o hilo
Ansible instalado y en PATH
@modelcontextprotocol/sdk (instalado automáticamente)

Instalación

1. Clonar el repositorio

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

2. Instalar dependencias

npm install

3. Construya el servidor

npm run build

4. Configurar los ajustes de MCP

Agregue el servidor Ansible MCP a su archivo de configuración de MCP.

Para VSCode con la extensión Claude:

Edite el archivo en ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Para la aplicación de escritorio Claude:

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

Agregue lo siguiente a la sección mcpServers :

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

Asegúrese de reemplazar /absolute/path/to/mcp-ansible con la ruta real a su instalación.

Ejemplos de uso

Una vez instalado y configurado, el servidor MCP proporciona las siguientes herramientas al asistente de IA:

1. Ejecutar un libro de jugadas

<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. Lista de inventario

<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. Verifique la sintaxis del libro de jugadas

<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. Enumere tareas en un libro de estrategias

<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. Acceder al recurso de inventario predeterminado

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

Desarrollo

Estructura del proyecto

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

Añadiendo nuevas funciones

Para agregar nuevas capacidades de Ansible al servidor MCP:

Modificar src/ansible-mcp-server/index.ts
Agregue su nueva herramienta en el método setupToolHandlers
Implemente una función de controlador para su herramienta
Reconstruir con npm run build

Licencia

Licencia MIT: consulte LICENCIA para obtener más detalles

Ansible MCP Server

Integrations