Ansible NLP MCP

Servidor MCP local para permitir que o Codex interaja com este repositório Ansible por linguagem natural, usando ferramentas seguras em vez de expor um shell genérico.

Ferramentas

• health: mostra raiz, timeout e se execução mutável está habilitada.
• list_playbooks: lista playbooks e workflows executáveis.
• inspect_playbook: resume plays, hosts, vars_files, tasks iniciais e variáveis obrigatórias comuns.
• suggest_playbooks: ranqueia playbooks a partir de um pedido em linguagem natural.
• inventory_graph: executa ansible-inventory --graph.
• inventory_summary: resume grupos e hosts do inventário.
• syntax_check: executa ansible-playbook --syntax-check.
• check_playbook: executa ansible-playbook --check.
• run_playbook: executa playbook real, bloqueado por padrão.
• ping_hosts: executa ansible -m ping ou ansible.windows.win_ping.
• list_logs e tail_log: consulta logs dentro de logs/.

Instalação

cd /root/ansible
python3 -m venv .venv-mcp
. .venv-mcp/bin/activate
pip install -r ansible_mcp/requirements.txt

Teste local

cd /root/ansible
. .venv-mcp/bin/activate
python -m ansible_mcp.server

Esse comando inicia um servidor MCP por stdio e fica aguardando um cliente MCP.

Configuração no Codex

Exemplo para .codex/config.toml no projeto, ou para ~/.codex/config.toml se quiser habilitar globalmente:

[mcp_servers.ansible]
command = "/root/ansible/.venv-mcp/bin/python"
args = ["/root/ansible/ansible_mcp/server.py"]
cwd = "/root/ansible"
enabled = true
startup_timeout_sec = 10
tool_timeout_sec = 900
env = { ANSIBLE_MCP_ROOT = "/root/ansible", ANSIBLE_MCP_ALLOW_RUN = "0" }

Com ANSIBLE_MCP_ALLOW_RUN = "0", o MCP permite inspeção, inventário, ping, syntax-check e check-mode, mas bloqueia execução real de playbooks.

Para permitir execução mutável:

[mcp_servers.ansible]
command = "/root/ansible/.venv-mcp/bin/python"
args = ["/root/ansible/ansible_mcp/server.py"]
cwd = "/root/ansible"
enabled = true
startup_timeout_sec = 10
tool_timeout_sec = 900
env = { ANSIBLE_MCP_ROOT = "/root/ansible", ANSIBLE_MCP_ALLOW_RUN = "1" }

Mesmo habilitado, run_playbook ainda exige confirm = "RUN" na chamada da ferramenta.

Exemplos de intenção NLP

• "Qual playbook eu uso para atualizar Windows do wuday1?"
• "Faça syntax-check do playbook de Windows Update com day=wuday1."
• "Rode em check mode a atualização Linux só no grupo rocky."
• "Mostre os últimos logs do Citrix Day."
• "Liste os grupos de inventário e quantos hosts existem em cada um."