mechub
// MISSION PROFILE

Sovereign network-security automation.

Open-source tools for people who run firewalls — self-hosted, offline-capable, no mandatory SaaS.

early · seeking testers
open source self-hosted github.com/mechubsec
scroll to inspect
// SEE IT WORK

Sanitize a config before you share it

A fabricated Junos config and what fwconfigsanitizer gives back. It is one HTML file that runs offline in your browser, and it also handles PAN-OS, FortiGate, ASA and Check Point.

Original (fabricated)
set system host-name edge-fw-chi01
set system root-authentication encrypted-password "$6$k3yS4lt$Qm9ndXNIYXNoRm9yRGVtb09ubHkxMjM0NTY3ODk"
set snmp community pr1v4teC0mm authorization read-only
set interfaces ge-0/0/0 description "Uplink to Northwind ISP circuit 4471"
set interfaces ge-0/0/0 unit 0 family inet address 64.39.102.18/29
set interfaces ge-0/0/1 unit 0 family inet address 10.20.30.1/24
set security zones security-zone trust-corp interfaces ge-0/0/1.0
set system ntp server ntp1.northwind-corp.com
Sanitized
set system host-name sanitized-fw
set system root-authentication encrypted-password "REDACTED_HASH_0"
set snmp community REDACTED_COMMUNITY_0 authorization read-only
set interfaces ge-0/0/0 description SANITIZED_DESC_0
set interfaces ge-0/0/0 unit 0 family inet address 192.0.2.163/29
set interfaces ge-0/0/1 unit 0 family inet address 10.96.205.113/24
set security zones security-zone zone-0 interfaces ge-0/0/1.0
set system ntp server host-0.example.net

Junos · 8 replaced: 2 IPs, 2 secrets, 2 hostnames, 2 other

Best-effort and provided as is: review the output before you share it.

Core Axiom

Deterministic decides. The model explains. A human approves.

01 · SOVEREIGN ARCHITECTURE

Your network. Your data. Your call.

"Sovereign" is not a slogan here — it is a design constraint every mechub tool is built against.

02 · REPOSITORIES ECOSYSTEM

Eighteen repos, all open

Everything below is early. It works in our lab against real gear; we need it to work in yours. Stats refresh live from GitHub when you're online. Hover over or tab to a card and the repos it depends on, plus the ones built on it, light up with it.

Foundation

Core libraries that power the MCP server ecosystem. (3 repos)

rust/library MIT

mecmcp

0 0 open issues

The shared Rust foundation under mechub's per-vendor firewall mcp servers — bearer-token auth, scopes, attribution and audit, transport hardening, and change control, written once instead of once per vendor. Consumed as a git dependency, not on crates.io.

Shared MCP server foundation updated jul 2026
foundation/rust MIT

rustnetconf

3 0 open issues

Async NETCONF client library for Rust — YANG code generation, vendor profiles, connection pooling, and a Terraform-like CLI for declarative network config.

Terraform-like network config updated jul 2026
foundation/rust MIT

rustez

1 0 open issues

A Rust replacement for Juniper PyEZ — async-first Junos device automation built on rustnetconf. Python wheels: Linux x86_64 only (other platforms build with maturin).

Async Junos device automation updated jul 2026

MCP servers

Enterprise MCP servers for vendor platforms, built on the mecmcp foundation. Maturity follows the mecmcp README: beta, alpha, or planned (not usable). (9 repos)

mcp/rust MIT

rustjunosmcp

2 3 open issues

MCP server that lets AI agents operate Juniper Junos and SRX devices (NETCONF) — built on rustez, exercised against a 24-device vSRX lab.

v2.4 stable · Junos/vSRX automation for AI agents updated jul 2026
mcp/rust MIT

rustpanosmcp

1 0 open issues

MCP server that lets AI agents operate Palo Alto PAN-OS firewalls — bearer-token device and tool scopes, a guarded candidate-config lifecycle with independent approval, and the same security posture as rustjunosmcp.

beta · PAN-OS automation with guarded config updated jul 2026
mcp/rust MIT

rustsdcmcp

0 0 open issues

Async mcp server for HPE Juniper Security Director Cloud — bounded read tools for discovery, and a prepare/approve/apply path for policy deployment instead of a direct deploy call.

alpha · Security Director Cloud policy automation updated sep 2026
mcp/rust MIT

rustmistmcp

0 0 open issues

Async mcp server for the HPE Juniper Mist cloud — bearer-token auth, org- and site-scoped tools, bounded responses, and guarded WAN-edge change control.

alpha · HPE Juniper Mist cloud automation updated sep 2026
mcp/rust MIT

rustproxmoxmcp

0 0 open issues

MCP server for Proxmox VE — one endpoint across many clusters, with destructive work held behind plan, approve and apply.

beta · Safety Plan/Apply Gating updated aug 2026
mcp/rust MIT

rustunifimcp

0 0 open issues

The UniFi Network member of the family — a curated, scoped, audited mcp surface over the controller API, the same shape rustjunosmcp gives Junos.

alpha · UniFi Network controller automation updated sep 2026
mcp/rust MIT

rustfortimcp

0 0 open issues

Enterprise MCP server for Fortinet FortiGate (then FortiManager) on the mecmcp foundation — scoped access, audited change control.

under construction · not usable yet · Rust updated sep 2026
mcp/rust MIT

rustopnsmcp

0 1 open issues

Enterprise MCP server for OPNsense on the mecmcp foundation — scoped access, audited change control.

under construction · not usable yet · Rust updated sep 2026
mcp/rust MIT

mecfeedmcp

0 0 open issues

Governed threat-intel → firewall feeds: propose, validate, approve, publish — firewalls pull, nothing is committed per indicator.

under construction · not usable yet · Rust updated oct 2026

Data

Security data platforms with MCP-first architecture. (1 repo)

platform/python MIT

ssdf

0 0 open issues

Sovereign Security Data Fabric — a deliberately minimal security data platform where the mcp tool surface is the product, not an afterthought. Vendor syslog normalised through Vector into ClickHouse, self-hosted end to end, with swappable Python store classes (ClickHouse by default). Reference deployment; no quick start.

MCP-first security data platform updated aug 2026

Skills & Tools

Agent skills, config conversion, sanitization, and sync utilities. (4 repos)

skills/LLM MIT

fwskillsshare

4 0 open issues

Agent skills for firewall work — parsing, auditing, and converting configs across Cisco, Fortinet, Palo Alto, and Juniper. Works with Claude Code, Codex, and Hermes so far.

Multi-vendor firewall parsing & conversion updated jul 2026
tool/browser/LLM MIT

firewallintentconverter

1 1 open issues

Browser-based conversion of firewall and cloud configs — PAN-OS, FortiGate, Cisco ASA/FTD, Check Point, SonicWall, Huawei USG, AWS/Azure/GCP, and more — into reviewable Juniper SRX output, with an LLM-guided greenfield mode. Always a migration draft requiring review — never production-ready.

Multi-vendor config migration to SRX updated jul 2026
tool/browser MIT

fwconfigsanitizer

1 0 open issues

Strips private data — addresses, hostnames, secrets — out of a firewall configuration so it can be shared for help or review. Review the output before sharing — validation warnings flag items it may have missed.

Privacy-safe config sharing updated jul 2026
tool/python MIT

srxsync

1 0 open issues

Pushes one SRX's config — policies, objects, NAT — out to a fleet of others, so a golden device can drive the rest. It does not follow the "a human approves" model: there is no approval step, so run check and --dry-run first; pushes use commit confirmed.

Golden-source SRX fleet sync updated jul 2026

Benchmarks

Network-automation agent benchmarking and evaluation. (1 repo)

benchmark/python MIT

mechubbench

0 0 open issues

Tool-call benchmark corpus and runner for network-automation agents — drives scenarios through local models and scores emitted tool-call sequences. Needs a local OpenAI-compatible endpoint (e.g. Ollama).

Agent tool-call benchmarking updated aug 2026
View All 18 Repositories on GitHub
03 · TRANSPARENCY & REALITY

Honest about where this is

Proof ahead of claims. Here is exactly what these tools are today — and what they are not yet.

Built against real gear.

Everything public here is developed and used in one real lab: a Proxmox cluster running a 24-device Juniper vSRX topology, exercised through real NETCONF sessions, real commits, and real multi-vendor configs.

Not yet battle-tested elsewhere.

No mechub tool has been proven at someone else's site. That is precisely the help we are asking for — see below.

Interfaces may change.

Until a 1.0, expect breaking changes; they'll be called out in release notes, not hidden.

The AI boundary is fixed.

Deterministic code decides, models explain, a human approves. That rule does not change as the tools mature.

Tested with

Server Device or software Basis
Junos MCP vSRX 26.2R1.7 lab
UniFi MCP UniFi Network Application ≥ 10.5.67, UniFi OS Server ≥ 5.1.37 minimum supported

Other servers: see each repo's README.

04 · ROADMAP TRACKER

Where it's going

These are goals in active development — not promises. Scope and timing may change; when something ships, it ships on GitHub first and gets announced here.

2026 · Shipped

The foundation went public

Open-source repositories spanning the Rust NETCONF stack, the Junos, PAN-OS, Mist, Security Director Cloud and UniFi MCP servers, browser firewall tools, and shared Claude skills. Eighteen listed above (three of them, rustfortimcp, rustopnsmcp and mecfeedmcp, are placeholders: under construction and not usable yet); all taking issues.

PLANNED · NO CODE YET

mecfeedmcp

Governed threat-intel feeds to firewalls: indicators are proposed, validated, approved and published as versioned feeds that firewalls pull. The repo is public, but it is under construction and not usable yet.

IN DEVELOPMENT · NOT YET PUBLIC

mecviz

A composable SecOps console: engineers and agents assemble boards over governed MCP data — zone matrices, rule analysis, feed history — and humans act through cross-platform change sets that honour each server's lab-mode or two-person approval. In development and not yet public.

05 · LAB TESTERS CALL

We need testers more than anything

The single most valuable thing you can do is run a tool against your own gear and tell us what happened — especially when the answer is "it broke".

03
Star, watch, improve

Stars and watches tell us where to spend effort. PRs are welcome too — but right now, issues from real environments matter more than code.

Join the testers thread
06 · FUN STUFF

Off the clock

Personal side projects built with the same tooling — not part of the security stack, just things we like having around.

radio/rust MIT

homeradio

0 0 open issues

An 80s boom box in the browser that plays internet radio through a Yamaha receiver over AirPlay — two zones, capped volume, and it never hijacks the TV.

Home audio side project updated oct 2026
GitHub Explore Repos
Getting Started

You need

  • A vSRX in EVE-NG/containerlab/Proxmox, or a spare SRX box
  • NETCONF over SSH: the server's default port is 22 (regular SSH, set system services ssh); for 830, enable set system services netconf ssh and set port in devices.json
  • Linux host with Rust 1.89+ (each repo pins its toolchain in rust-toolchain.toml; rustup fetches it on first build) OR Docker

Quick start (from source)

  1. Clone and build:
    git clone https://github.com/mechubsec/rustjunosmcp.git
    cd rustjunosmcp
    cargo build --release
  2. Configure devices:
    cp devices-template.json devices.json
    chmod 600 devices.json  # the server refuses a group- or world-readable inventory
    # Edit devices.json with your SRX details
  3. Run as MCP server:
    ./target/release/rust-junosmcp -f devices.json
  4. Register with Claude Desktop:
    {
      "mcpServers": {
        "junos": {
          "command": "/path/to/rust-junosmcp",
          "args": ["-f", "/path/to/devices.json"]
        }
      }
    }
    Running as your own user rather than the packaged service? Use examples/: it adds the per-user state, lease and staging paths the defaults under /var/lib/jmcp need.

Writes: read tools work out of the box. Writes go through change sets that need a second approver; single-operator labs can pass --lab-mode (recorded as approval_waiver: "lab-mode"; not for production). Direct-commit tools (load_and_commit_config, render_and_apply_j2_template when applying, rollback_config with commit, upgrade_junos with confirm) are refused unless you pass --allow-direct-commit.

Docker alternative: docker pull ghcr.io/mechubsec/rustjunosmcp:latest (or the Docker Hub mirror, docker.io/mechub/rustjunosmcp) — see README's Docker section for setup.

File an Issue

What to include

  • What you ran (exact command or steps)
  • What broke (error message or unexpected behavior)
  • Device model and your exact OS version (e.g., vSRX 26.2R1.7)
  • What you expected to happen

Choose a repository