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

---

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