mcp-infra-readonly

Serveur MCP (Model Context Protocol) Python donnant à Claude Code un accès strictement en lecture à l'infrastructure Epiconcept — logs, état des services, métriques, facts Ansible, état Docker.

Repos liés :

• Ce repo : https://github.com/senseicoder/mcp-infra-readonly
• Sandbox Docker Claude Code : https://github.com/senseicoder/claude-sandbox

Principe de sécurité

• Zéro écriture : aucun outil ne peut modifier l'état d'un serveur
• Double validation : validation.py (regex strictes + blocage des caractères d'injection) avant toute commande SSH
• Liste blanche : seules les commandes listées dans config/allowlist.yml sont exécutables — rechargement à chaud, pas de redémarrage nécessaire
• Filtre de sortie : output_filter.py bloque les clés privées, masque les mots de passe/tokens avant retour à Claude
• Pas de sudo : toutes les commandes s'exécutent avec les droits de l'utilisateur SSH
• Transport stdio : le serveur tourne en local, communique via stdin/stdout avec Claude Code
• Pas de credentials en dur : la configuration SSH utilise les clés SSH existantes de l'hôte

Outils MCP exposés

Outil	Description	Commande SSH sous-jacente
list_hosts	Liste les hosts Ansible connus	lecture inventory
Services
get_service_status	État d'un service systemd	systemctl status <service>
get_failed_services	Services systemd en état failed	systemctl --failed
get_process_list	Top processus CPU/RAM	ps aux --sort=-%cpu | head -20
get_system_info	Uptime, mémoire, version OS	uptime, free -h, uname -a
get_open_ports	Ports TCP en écoute	ss -tlnp
Logs
get_log_tail	Dernières N lignes d'un log	tail -n N <path>
get_journal	Logs systemd via journalctl	journalctl -u <service> -n N
list_log_files	Liste un répertoire de logs	ls -lh <path>
Disque
get_disk_usage	Utilisation disque	df -h
get_inode_usage	Utilisation inodes	df -i
Docker
get_docker_status	État des containers	docker ps -a
get_docker_stats	CPU/RAM des containers (snapshot)	docker stats --no-stream
get_docker_logs	Logs d'un container	docker logs --tail N <container>
get_docker_inspect	Config/volumes/réseau d'un container	docker inspect <container>
Ansible
get_ansible_facts	Facts Ansible d'un host	ansible <host> -m setup

Installation

pip install -e .

Configuration

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

L'allowlist (config/allowlist.yml) est rechargée à chaque appel — aucun redémarrage du serveur MCP n'est nécessaire après modification.

Utilisation avec Claude Code

Ajouter dans .mcp.json du projet ou dans ~/.claude/settings.json :

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

Dans la sandbox Docker, ce MCP est configuré dans config/mcp.json du repo claude-sandbox.

Architecture

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