mcp-wallfacer
v0.8.1
Published
Runtime fuzzing and invariant-testing harness for MCP servers — catch crashes, hangs, schema drift, and state leaks before they ship.
Downloads
777
Maintainers
Readme
mcp-wallfacer (npm wrapper)
Thin npm wrapper around the
mcp-wallfacerRust binary. Installs the matching platform binary from the GitHub release atpostinstalltime and exposes it aswallfacer.
npm install -g mcp-wallfacer
wallfacer --helpWhat it installs
| Platform | Architecture | Triple |
|---|---|---|
| Linux | x86_64 | x86_64-unknown-linux-gnu |
| Linux | aarch64 | aarch64-unknown-linux-gnu |
| macOS | Intel | x86_64-apple-darwin |
| macOS | Apple silicon | aarch64-apple-darwin |
| Windows | x86_64 | x86_64-pc-windows-msvc |
For other platforms, build from source:
cargo install mcp-wallfacerEnvironment variables
| Var | Default | Purpose |
|---|---|---|
| WALLFACER_VERSION | v<package.json#version> | Pin the GH release to download. |
| WALLFACER_SKIP_INSTALL | unset | When 1, the postinstall script is a no-op. Useful in container builds that vendor the binary themselves. |
How the wrapper works
postinstall(scripts/install.js) runs once pernpm install.- It maps
process.platform×process.archto a Rust target triple, downloads the matching GitHub release tarball, and extracts thewallfacerbinary intonode_modules/mcp-wallfacer/bin/. bin/wallfacer.js(the package's onlybinentry) is a tiny shim that forwards argv + stdio to the binary and exits with its exit code.
The wrapper does not execute any Rust at runtime; it just runs the
prebuilt binary verbatim, so behaviour is identical to a direct
cargo install of the same version.
