Skip to main content
Glama

network_medic

An autonomous network monitoring and auto-remediation MCP server for Claude Desktop.

Claude Desktop acts as the LLM brain — it observes the network state, decides the remediation plan, presents each action to the user for approval, executes, verifies, and summarises the session.

No separate Anthropic API key required.


Architecture

Observe → Plan (Claude Desktop) → Policy Validation → Human Approval → Execute → Verify → Log + Learn

MCP Tools

Tool

Description

observe_network

Runs probes (connectivity, DNS, latency), returns state + diagnostic context

execute_action

Executes a single approved action

verify_action

Post-action probe diff — returns resolved / unchanged / degraded

finalise_session

Saves final state, returns session summary

get_action_history

View recent action log

submit_feedback

Rate the session outcome


Related MCP server: EVE-NG MCP Server

Project Structure

server/          MCP entry point + pipeline stage functions
modules/
  monitor/       Observe — connectivity, DNS, latency probes
  planner/       Context builder — prompt + memory injection
  policy/        Safety — conflict checks, cooldowns, risk caps
  remediate/     Execute — HIL gate, OS-specific commands
  verifier/      Verify — post-action probe diff
  rollback/      Recover — snapshot + revert
memory/          Persistent state — action log, state history, feedback
prompts/         LLM prompt templates
schemas/         JSON Schema contracts
utils/           Shared infrastructure

Setup

1. Clone the repo

git clone https://github.com/your-username/network_medic.git
cd network_medic

2. Create a virtual environment and install dependencies

python -m venv venv

# Windows
venv\Scripts\python.exe -m pip install -r requirements.txt

# Linux / macOS
source venv/bin/activate && pip install -r requirements.txt

3. Wire into Claude Desktop

Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "network-medic": {
      "command": "C:/path/to/network_medic/venv/Scripts/python.exe",
      "args": ["C:/path/to/network_medic/server/mcp_server.py"],
      "cwd": "C:/path/to/network_medic"
    }
  }
}

Replace C:/path/to/network_medic with your actual clone path.

Restart Claude Desktop after saving the config.


Local Debug Run

Runs the full pipeline in the terminal without Claude Desktop:

python main.py

Supported Platforms

  • Windows

  • Linux

  • macOS


Requirements

  • Python 3.13+

  • Claude Desktop

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    MCP server that turns Claude into a UniFi network specialist. Manage devices, optimize WiFi, audit security, and troubleshoot your network through natural language.
    31
    9 npm
    2
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that gives Claude Desktop persistent memory, self-awareness, epistemic hygiene, and genuine agency across conversations with a typed memory system, embedding-based semantic search, a 3-judge memory jury, and a real-time dashboard.
    7
    MIT