whatisgithub

What is mcpfz-probe?

agent-hellboy/mcpfz-probe — explained in plain English

Analysis updated 2026-05-18

2RustAudience · developerComplexity · 4/5Setup · hard

In one sentence

A runtime security probe that watches what an MCP server actually does on the system while it's being fuzz tested, and ties each action back to the tool call that caused it.

Mindmap

mindmap
  root((mcpfz-probe))
    What it does
      Watches runtime events
      Attributes to tool calls
      Pairs with mcp-server-fuzzer
    Tech stack
      Rust sidecar
      Python monitor
      eBPF backend
    Use cases
      Fuzz testing MCP servers
      Security finding attribution
      Kernel level monitoring
    Audience
      Security researchers
      MCP server developers
    Backends
      Fake scripted mode
      Real eBPF mode

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Monitor an MCP server's real system behavior during automated fuzz testing.

USE CASE 2

Attribute suspicious actions like network connections or file deletions to the exact tool call that caused them.

USE CASE 3

Test fuzzing pipelines without root access using the deterministic fake backend.

USE CASE 4

Catch security issues like shell execution or sensitive file reads in a vulnerable MCP server on Linux.

What is it built with?

RustPythoneBPF

How does it compare?

agent-hellboy/mcpfz-probe132ikl/game1lystore/pay-dcp
Stars222
LanguageRustRustRust
Last pushed2020-12-30
MaintenanceDormant
Setup difficultyhardmoderatemoderate
Complexity4/52/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

The real eBPF backend needs a BTF-enabled Linux kernel, root or CAP_BPF, and a nightly Rust toolchain with LLVM dev libraries.

No license information found in the README.

So what is it?

This is a security testing companion tool. It works alongside a separate project called mcp-server-fuzzer, which is a tool that automatically tests MCP servers, the services AI assistants call out to, by sending them unexpected or malformed inputs to look for bugs and security holes. While that fuzzer handles starting the process being tested and timing each call, this project watches what actually happens on the computer while each call runs, and connects those observed events back to the specific call that caused them. It is split into two parts. A small Rust program, called the sidecar, does the actual low level watching, since Rust is well suited for a small, easily checked, high performance program. A Python library handles coordinating with the fuzzer and deciding whether an observed event counts as a problem. The watching itself works two ways. A simple fake mode replays a scripted set of events for testing purposes, requiring no special system permissions and running on any operating system. A real mode, available only on Linux, uses a kernel technology called eBPF to directly observe system calls such as starting a new program, opening a network connection, opening or deleting a file, or attaching a debugger to a process. This real mode has been tested against a deliberately vulnerable example server and successfully caught it running shell commands, reading sensitive files, connecting out over the network, and manipulating files, attributing each of these actions to the exact tool call that triggered it. Developers using the two tools together turn this monitoring on with a few environment variables, and the fuzzer's final report then includes these kernel level findings alongside its usual results. The project includes both Python and Rust test suites and documentation covering its communication protocol and internal architecture.

Copy-paste prompts

Prompt 1
Explain how mcpfz-probe attributes a kernel event like a network connection back to a specific tool call.
Prompt 2
Walk me through running mcpfz-probe's eBPF backend on Linux with mcp-server-fuzzer.
Prompt 3
Show me how to use mcpfz-probe's fake backend to test my fuzzing setup without root access.
Prompt 4
What syscall categories does mcpfz-probe's eBPF backend capture as findings?

Frequently asked questions

What is mcpfz-probe?

A runtime security probe that watches what an MCP server actually does on the system while it's being fuzz tested, and ties each action back to the tool call that caused it.

What language is mcpfz-probe written in?

Mainly Rust. The stack also includes Rust, Python, eBPF.

What license does mcpfz-probe use?

No license information found in the README.

How hard is mcpfz-probe to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is mcpfz-probe for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.