netcfg-agent-mcp

Serveur MCP standalone pour netcfg-agent. Expose le code metier netcfg (inventaire Visio, preview deploy, topologie, terminal SSH live multi-vendor) comme tools MCP consommables par n importe quel client compatible (Claude Desktop, Gemini CLI 0.38+, Roo Code, Cline, Cursor, etc.).

Positionnement

Ce repo est le 4eme de la famille netcfg-agent :

• naarob/netcfg-agent : master, code metier complet (web + TUI + binaire PyInstaller)
• naarob/netcfg-agent-web : fork web-only
• naarob/netcfg-agent-tui : fork TUI-only
• naarob/netcfg-agent-mcp (ce repo) : fork serveur MCP standalone

Il n est pas un sous-ensemble fonctionnel du master mais une couche d exposition protocolaire par-dessus. Il depend du master pour le code metier.

Architecture (Phase 1 - Scenario 2)

+----------------------+         +--------------------+
| MCP client           |         | LaForge hub        |
| (Claude/Gemini/Roo)  |         | 127.0.0.1:8766     |
+----------+-----------+         | (optionnel)        |
           |                     +----+---------------+
           | Streamable HTTP          | lib imports
           |                          |
           v                          v
+---------------------------------------------+
|   netcfg-agent-mcp                          |
|   127.0.0.1:8767                            |
|   - Tools metier : list_equipments,         |
|     get_dashboard, preview_deploy,          |
|     topology, audit, open_terminal,         |
|     verify_chain, vendors                   |
|   - Heritage optionnel : authority,         |
|     transport HTTP de LaForge si dispo      |
+----------+----------------------------------+
           | imports
           v
+--------------------------+
|   netcfg-agent (master)  |
|   Session, Visio parser, |
|   PTY SSH, WAL hash-chain|
+--------------------------+

Port 8767 par defaut pour cohabiter avec LaForge sur 8766.

Installation via binaire (sans Python)

Les releases GitHub fournissent le binaire autonome netcfg-agent-mcp.exe (Windows x64, ~130 MB) qui embarque :

• Python 3.12 runtime
• Le code netcfg-agent master (tous les tools metier)
• mcp SDK + FastAPI + uvicorn + asyncssh + pyte
• Les templates vendor et la demo enterprise_network.vsdx

Telechargez depuis les releases et lancez directement :

netcfg-agent-mcp.exe --version
netcfg-agent-mcp.exe serve --transport http

Installation (Python)

pip install netcfg-agent-mcp
REM tire netcfg-agent[terminal] (code metier + terminal PTY SSH)

netcfg-agent-mcp --version
netcfg-agent-mcp --help

Developpement : depuis un clone, pip install -e ".[dev]".

Licence : AGPL-3.0-or-later (voir LICENSE).

Usage

Lancer le serveur

REM Mode HTTP (port 8767)
netcfg-agent-mcp serve

REM Mode stdio (pour spawn par Claude Desktop)
netcfg-agent-mcp serve --transport stdio

REM Mode standalone (aucun hook LaForge)
netcfg-agent-mcp serve --standalone

REM Custom port
netcfg-agent-mcp serve --port 8777

Configurer un client MCP

Claude Desktop (claude_desktop_config.json) :

{
  "mcpServers": {
    "netcfg-agent-mcp": {
      "command": "netcfg-agent-mcp",
      "args": ["serve", "--transport", "stdio"]
    }
  }
}

Gemini CLI (settings.json) :

{
  "mcpServers": {
    "netcfg-agent-mcp": {
      "httpUrl": "http://127.0.0.1:8767/mcp",
      "headers": {
        "Authorization": "Bearer <token-genere-au-premier-run>",
        "X-Agent-Name": "GEMINI"
      }
    }
  }
}

Roo Code (.roo/mcp.json) :

Copier .roo/mcp.json.example en .roo/mcp.json et remplacer le placeholder.

Tools exposes (v0.1)

Authentification

• Bearer token local genere au premier run, stocke dans %USERPROFILE%\.netcfg-agent-mcp\token (ACL user-only)
• Permissions heritees de LaForge si hub dispo (authority_status)
• Fallback : lock SQLite local hash-chainee (via db_waldb du master)

Historique decisions

Voir ROADMAP_MCP_FORK.md dans le repo master pour l historique complet des decisions d architecture.

Points cles :

• Phase 1 (actuelle) : dep directe LaForge via pyproject (Scenario 2)
• Phase 2 (differee) : extraction laforge-mcp-core (Scenario 3)
• Budget binaire PyInstaller : < 180 MB
• Flag --standalone : desactive tous hooks LaForge