Skip to content
MCP server

NetOps Field Notes

Read-only network config checks: drift, CIS/PCI, 802.1X, certs and change risk

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.1
Listing updated
3 days ago

About NetOps Field Notes

NetOps Field Notes is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Aimed at network engineers, this server takes configs and logs as pasted text and answers the checks done by hand on gear. It is read-only and deterministic, with no model call, so two engineers get the same answer, and it reads nothing from disk.

The config diff tool groups changes by section and rates risk for EdgeOS, RouterOS, OPNsense, EdgeSwitch and Cisco IOS-style configs. The 802.1X tool takes a RADIUS log, switchport config or supplicant log and names the failure, such as an EAP mismatch or a missing dynamic VLAN. Another tool finds certificates buried in configs, which web monitors never see, and flags the expiring, weak or self-signed ones.

There is also an OPNsense firewall change explainer, a Mermaid topology builder, a pre-flight gate for proposed changes and a sanitiser that scrubs secrets before a config is shared. Install runs through uvx (Python 3.10 or newer) or Docker.

Install

Run in a terminal

claude mcp add netops-field-notes-mcp -- docker run -i --rm ghcr.io/getlarkwright/netops-field-notes-mcp:0.1.1

Add to claude_desktop_config.json

{
  "mcpServers": {
    "netops-field-notes-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/getlarkwright/netops-field-notes-mcp:0.1.1"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "netops-field-notes-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/getlarkwright/netops-field-notes-mcp:0.1.1"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "netops-field-notes-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/getlarkwright/netops-field-notes-mcp:0.1.1"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "netops-field-notes-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/getlarkwright/netops-field-notes-mcp:0.1.1"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "netops-field-notes-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/getlarkwright/netops-field-notes-mcp:0.1.1"
      ]
    }
  }
}

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

explain_config_diff
What changed between two snapshots, grouped by section and risk-rated.
check_config_compliance
Ten CIS/PCI checks with a one-line fix per miss.
diagnose_dot1x
Why a port fails 802.1X, from logs and configs.
lookup_ise_failure_code
Meaning and fix for an ISE step code.
find_certs_in_config
Certificates embedded in a config and their problems.
check_tls_endpoint
Certificate findings for a public host.
extract_device_facts
Hostname, role, addresses, subnets and VLANs from a config.
infer_topology
Which devices share segments, as a Mermaid diagram.
explain_firewall_change
An OPNsense config.xml change, rule by rule.
preflight_change
Risk, compliance regressions, blast radius and a gate verdict.
sanitize_config
Scrub secrets and map addresses consistently.
latest_field_note
What happened in networking this week.

What it does

Config drift explainer
Groups changes by section and rates the risk in plain English.
802.1X diagnosis
Names why a port fails to authenticate from RADIUS, switch and supplicant logs.
Certificates in configs
Finds embedded certificates and flags expiring, weak or self-signed ones.
Firewall change review
Explains an OPNsense config.xml change rule by rule, including shadowing.
Change pre-flight
Returns risk, compliance regressions, blast radius and a gate verdict.
Config sanitiser
Scrubs secrets and maps addresses consistently before sharing.

Good for

  • Find out what changed on a router overnight
  • Debug a switch port that will not pass 802.1X
  • Catch a certificate about to expire inside a device config
  • Review an OPNsense rule change before applying it
  • Draw which devices share a segment

Pricing

Open source

Free; no account or telemetry

Prices change. Check netopsfieldnotes.com before you buy.

NetOps Field Notes FAQ

Does it call a model or read my files?

No. It is deterministic and read-only, and configs and logs go in as text.

Which vendors does the diff tool understand?

EdgeOS, RouterOS, OPNsense, EdgeSwitch and Cisco IOS-style configs.

How is it installed?

With uvx from the pinned GitHub tag v0.1.1, or as a Docker image on ghcr.io.

Can it explain Cisco ISE failure codes?

Yes, lookup_ise_failure_code explains step codes such as 12514 and suggests fixes.

Is NetOps Field Notes free?

Yes. NetOps Field Notes is open source, so you can use and self-host it for free.

How do I add NetOps Field Notes to Claude Code?

Run this command in your terminal: claude mcp add netops-field-notes-mcp -- docker run -i --rm ghcr.io/getlarkwright/netops-field-notes-mcp:0.1.1

What are the best alternatives to NetOps Field Notes?

The closest alternatives to NetOps Field Notes are REA, Codebase Memory, XERJ, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to NetOps Field Notes

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools