mcp-oxidized

MCP server for Oxidized - network device configuration backup tool.

Exposes Oxidized data as MCP tools so that LLM assistants can query, compare and analyse network device configurations via natural language.

Features

Related MCP server: mcp-server-sros

Requirements

• Python 3.11+

• Oxidized with oxidized-web running (REST API enabled)

• Docker (recommended)

Quick Start

cp .env.example .env
# Edit .env with your Oxidized URL and credentials
docker compose up -d

The MCP server listens on port 8000 (Streamable HTTP transport).

Configuration

MCP Client Configuration

Add to your MCP client (e.g. Claude Desktop mcp.json):

{
  "mcpServers": {
    "oxidized": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

Example Prompts

• "List all devices and show me which ones failed their last backup."

• "List all stored versions for HFGBF253-IT in the Firewalls group."

• "Show me the current config of router01 and annotate each line with the version that last changed it."

• "Show me the current config of switch02 and highlight all changes compared to version 12."

• "Show the diff between version 12 and version 14 for firewall01 with 10 lines of context."

Development

pip install -e ".[dev]"
python -m mcp_oxidized.server

License

MIT