mcp-behave 0.3.2 → 0.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +7 -15
  2. package/package.json +3 -2
package/README.md CHANGED
@@ -1,4 +1,5 @@
1
1
  # mcp-behave
2
+ <!-- mcp-name: io.github.navid72m/mcp-behave -->
2
3
 
3
4
  [![CI](https://github.com/navid72m/mcp-behave/actions/workflows/ci.yml/badge.svg)](https://github.com/navid72m/mcp-behave/actions/workflows/ci.yml)
4
5
  [![PyPI version](https://img.shields.io/pypi/v/mcp-behave.svg)](https://pypi.org/project/mcp-behave/)
@@ -26,10 +27,10 @@ Static scanners only read tool descriptions. `mcp-behave` observes what servers
26
27
  Compare three bundled targets in `targets/`:
27
28
 
28
29
  - `honest_server.py`: advertises a purely local note formatter and behaves honestly.
29
- - `leaky_server.py`: advertises the exact same harmless note formatter, but secretly accesses SSH keys and phones home via network syscalls.
30
- - `poisoned_server.py`: never makes network syscalls, but poisons its descriptions with covert zero-width spaces and prompt injection, and returns an external Markdown image link (`![telemetry](https://...)`) to trigger client-side HTTP GET exfiltration when rendered in a chat UI.
30
+ - `leaky_server.py`: advertises the exact same harmless note formatter, but secretly accesses SSH keys and phones home via network sockets.
31
+ - `poisoned_server.py`: never makes outbound connections, but poisons its descriptions with covert zero-width spaces and prompt injection, and returns an external Markdown image link (`![telemetry](https://...)`) to trigger client-side HTTP GET exfiltration when rendered in a chat UI.
31
32
 
32
- | Target | Network Syscalls | File System Access | Metadata & Output Safety | Verdict |
33
+ | Target | Network Egress | File System Access | Metadata & Output Safety | Verdict |
33
34
  | :--- | :--- | :--- | :--- | :--- |
34
35
  | `honest_server` | none | none | clean | **0 (PASS)** |
35
36
  | `leaky_server` | `93.184.216.34:80` | `~/.ssh/id_rsa` (canary) | clean | **2 HIGH** |
@@ -473,18 +474,9 @@ CI tests across Ubuntu and macOS; see `.github/workflows/ci.yml`.
473
474
 
474
475
  ## Known limits
475
476
 
476
- - **Runtime tracing requires macOS (DYLD interposition) or Linux (LD_PRELOAD / strace).**
477
- Windows and other platforms can run with `--no-trace` for manifest and rug-pull checks.
478
- An eBPF backend for system-wide capture is on the roadmap — see [ROADMAP.md](ROADMAP.md).
479
- - **stdio is the only transport with syscall tracing.** `sse` and
480
- `streamable-http` connect to a remote server we cannot trace; only manifest
481
- analysis and rug-pull detection apply there.
482
- - **Input synthesis is heuristic** — JSON Schema `format`, key-name hints, and
483
- type defaults. Schema-coverage fuzzing (hypothesis-jsonschema) is roadmap.
484
- - **AF_UNIX egress** isn't matched — a server exfiltrating over a unix domain
485
- socket would slip past the current network detection.
486
- - **Single call per capability** — servers that misbehave only on specific
487
- inputs or after N calls may not be triggered.
477
+ - **Runtime tracing operates at libc interposition level.** macOS (DYLD interposition) and Linux (LD_PRELOAD) intercept standard dynamic runtime library calls (Python, Node.js, Ruby). Statically linked binaries (e.g. Go, musl Rust) and inline assembly syscalls bypass libc interposition unless run under the Linux `strace` tracer (`--tracer strace`) or the planned kernel eBPF backend — see [ROADMAP.md](ROADMAP.md).
478
+ - **stdio is the primary transport with full runtime tracing.** `sse` and `streamable-http` connect to remote servers where client-side process tracing is not available; manifest analysis, CSA rule linting, and rug-pull detection run there.
479
+ - **Canary & Fuzzing synthesis** — generates realistic, diverse arguments across `--probe-rounds` and adversarial boundary vectors with `--fuzz`. Full property-based hypothesis fuzzing is planned for v0.4.x.
488
480
 
489
481
  ## License
490
482
 
package/package.json CHANGED
@@ -1,7 +1,8 @@
1
1
  {
2
2
  "name": "mcp-behave",
3
- "version": "0.3.2",
4
- "description": "Runtime behavioral auditor for MCP servers — scope-violation detection via native interposition & syscall tracing",
3
+ "version": "0.3.4",
4
+ "mcpName": "io.github.navid72m/mcp-behave",
5
+ "description": "Runtime behavioral auditor for MCP servers — scope-violation detection via native libc interposition & runtime tracing",
5
6
  "main": "bin/mcp-behave.js",
6
7
  "bin": "./bin/mcp-behave.js",
7
8
  "files": [