
NetOps Field Notes
Read-only network config checks: drift, CIS/PCI, 802.1X, certs and change risk
- 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.1Add 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"
]
}
}
}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"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP 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

Nautilus Compass Memory
MCP serverLocal-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
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools