# NetOps Field Notes

> NetOps Field Notes is an open-source MCP server for knowledge and memory. Read-only network config checks: drift, CIS/PCI, 802.1X, certs and change risk. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://netopsfieldnotes.com
- **Repository:** https://github.com/getlarkwright/netops-field-notes-mcp
- **MCP Registry name:** io.github.getlarkwright/netops-field-notes-mcp
- **Categories:** knowledge and memory, cloud and infrastructure, security
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.

---
Source: https://ai-powered.com/mcp/netops-field-notes
