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

• Liste blanche explicite : seules les commandes listées dans config/allowlist.yml sont exécutables

• 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

Related MCP server: MySQL MCP Server

Outils MCP exposés

Installation

pip install -e .

Configuration

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

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"
    }
  }
}

Architecture

mcp-infra-readonly/
├── src/mcp_infra/
│   ├── server.py       # point d'entrée MCP
│   ├── config.py       # chargement config + allowlist
│   └── tools/
│       ├── ssh.py      # helper SSH lecture seule
│       ├── services.py # get_service_status, get_process_list
│       ├── logs.py     # get_log_tail, get_disk_usage
│       ├── docker.py   # get_docker_status
│       └── ansible.py  # get_ansible_facts, list_hosts
├── config/
│   ├── hosts.yml.example
│   └── allowlist.yml   # liste blanche des commandes autorisées
└── tests/