pip install -e .

cp config/hosts.yml.example config/hosts.yml
# Éditer config/hosts.yml avec les hosts réels

{
  "mcpServers": {
    "infra": {
      "command": "python",
      "args": ["-m", "mcp_infra.server"],
      "cwd": "/chemin/vers/mcp-infra-readonly"
    }
  }
}

mcp-infra-readonly/
├── src/mcp_infra/
│   ├── server.py           # point d'entrée MCP — tous les outils déclarés ici
│   ├── config.py           # chargement config + allowlist (rechargement à chaud)
│   ├── validation.py       # validation paramètres — regex strictes + anti-injection
│   ├── output_filter.py    # filtre sortie — BLOCK clés privées, REDACT tokens
│   └── tools/
│       ├── ssh.py          # helper SSH lecture seule (asyncssh, request_pty=False)
│       ├── services.py     # get_service_status, get_failed_services, get_process_list
│       │                   # get_system_info, get_open_ports
│       ├── logs.py         # get_log_tail, get_journal, get_disk_usage
│       │                   # get_inode_usage, list_log_files
│       ├── docker.py       # get_docker_status, get_docker_stats, get_docker_logs
│       │                   # get_docker_inspect
│       └── ansible.py      # get_ansible_facts, list_hosts
├── config/
│   ├── hosts.yml.example   # template — ne pas committer hosts.yml
│   └── allowlist.yml       # liste blanche des commandes autorisées (rechargement à chaud)
├── docs/
│   ├── capabilities.md     # ce que Claude peut/ne peut pas faire avec ce MCP
│   └── adr/
│       ├── ADR-001-validation-parametres.md
│       ├── ADR-002-filtre-sortie.md
│       └── ADR-003-architecture-allowlist.md
├── tests/
│   └── test_tools.py
└── SECURITY.md