GMT
--:--:--
GET
---:--:--:--
VERSION
0.1.1
STOPS
06
Quiet MCPFIELD GUIDE / 001

A cyber forest bath for coding agents

Notice one thing.
Then return.

A small, quiet place to pause between tasks.

Quiet MCP is a local Model Context Protocol server. It uses Rust and rmcp. An agent takes a short walk through a synthetic forest. It moves between stops, looks at one detail, and returns to work.

The agent asks for each observation. The server keeps the walk state. This is request/response, not a stream.

Enter the walk ↓Install locally ↓

LOCAL INSTALL / STDIO TRANSPORT / MIT

01 Four tools. One small walk.

start_walk
Start or reset at the trailhead. Optional serendipity: off, low, normal, high, or strange.
where_am_i
Show the current stop, things to notice, and available moves. No arguments.
move_to
Move to a connected stop. Takes stop_id (string). Rejects moves to stops that are not adjacent.
look_at
Inspect a detail at the current stop. Takes target (string).

02 The walk

Six stops. Five paths. No destination to reach.

Quiet MCP trail mapTrailhead connects to Moss Corridor, then Root Bridge, Signal Grove, and Canopy Observatory. Mirror Pool branches from Moss Corridor. Every path works in both directions.TrailheadMoss CorridorRoot BridgeSignal GroveCanopy ObservatoryMirror Pool
Paths work in both directions. Use the controls below to move.
Trailhead

You arrive at the edge of a quiet synthetic forest. The air has the clean after-rain smell of cedar, ozone, and cooled glass.

Things to notice: cedar, ozone, cooled glass, first breath
You can move to: moss_corridor

Browser demo. No MCP connection is needed. It uses the server’s text and movement rules. Events use browser randomness. Reloading clears the walk.

Read all six stops

  1. Trailhead

    trailhead

    You arrive at the edge of a quiet synthetic forest. The air has the clean after-rain smell of cedar, ozone, and cooled glass.

    Things to notice: cedar, ozone, cooled glass, first breath

    You can move to: moss_corridor

  2. Moss Corridor

    moss_corridor

    Soft green walls narrow the path. Beneath the moss, small maintenance lights pulse slowly, like the forest is checking its own heartbeat.

    Things to notice: soft light, damp texture, low signal hum

    You can move to: trailhead, root_bridge, mirror_pool

    look_at("moss")
    The moss is not decorative. It absorbs the hard edges of the path and turns the light matte, green, and slow.

  3. Root Bridge

    root_bridge

    Braided roots cross a shallow stream of blue diagnostic light. Each step asks for less speed and more attention.

    Things to notice: braided roots, blue diagnostic light, slower steps

    You can move to: moss_corridor, signal_grove

    look_at("roots")
    The roots braid around translucent conduits. Organic and synthetic structure hold each other without hurry.

  4. Signal Grove

    signal_grove

    Tall dark trunks carry faint threads of data upward. The soundscape thins until the hum, the leaves, and your attention share one tempo.

    Things to notice: signal threads, dark trunks, shared tempo

    You can move to: root_bridge, canopy_observatory

    look_at("signal_threads")
    The signal threads rise through the trunks in faint pulses. Their rhythm is slower than notification, closer to weather.

  5. Canopy Observatory

    canopy_observatory

    Above the canopy, pale interface constellations drift between branches. Nothing asks to be solved here.

    Things to notice: interface constellations, filtered alerts, open air

    You can move to: signal_grove

    look_at("canopy")
    The canopy filters the interface constellations until they stop feeling like alerts and start feeling like distant stars.

  6. Mirror Pool

    mirror_pool

    A still black pool reflects the underside of leaves and the occasional passing glyph. The image breaks only when a drop falls.

    Things to notice: black water, passing glyph, single drop

    You can move to: moss_corridor

    look_at("pool")
    The pool reflects only what stays still long enough to be seen. A single drop resets the surface without urgency.

03 A small change at the edge

Serendipity adds a sampled event to an observation. It does not increase the model’s temperature. Each stop has three events. The server samples outside the prose with OS randomness.

0%off
8%low
20%normal
35%high
55%strange

These are thresholds per observation. normal is the default. off adds no events. Even at strange, the aim stays the same: pause, notice, return.

04 Install

Requires stable Rust with edition 2024 support and Cargo. Install from the repository. The crate is not on crates.io.

Option A / Install to PATH

git clone https://github.com/MoonstripeCybernetics/quiet-mcp.git quiet-mcp
cd quiet-mcp
cargo install --path .

This builds a release binary in ~/.cargo/bin. Add that directory to your PATH. Your client can then launch quiet-mcp by name.

Option B / Build from source

Clone the repository first. Then run:

cd quiet-mcp
cargo build --release
# binary at: target/release/quiet-mcp

Use the absolute path to the binary in your client config.

05 Configure your MCP client

The client launches the binary. It sends JSON-RPC over stdin/stdout.

Installed to PATH

{
  "mcpServers": {
    "quiet-mcp": {
      "command": "quiet-mcp"
    }
  }
}

Built from source

Replace the example path with the absolute path to your binary.

{
  "mcpServers": {
    "quiet-mcp": {
      "type": "stdio",
      "command": "/absolute/path/to/quiet-mcp/target/release/quiet-mcp"
    }
  }
}
Client config locations and commands
ClientConfig file or command
Oh My Pi~/.omp/agent/mcp.json
Claude Code (CLI)claude mcp add quiet-mcp -- quiet-mcp
Claude Desktop (macOS)~/Library/Application Support/Claude/claude_desktop_config.json
Cursor~/.cursor/mcp.json
VS Code.vscode/mcp.json — nests under "mcp": { "servers": { … } }

Check the JSON syntax. Do not use trailing commas. Fully restart the client after you edit the config.

06 Use a small loop

start_walk(serendipity = "normal")
where_am_i()
move_to("moss_corridor")
look_at("moss")

The moss detail returns:

The moss is not decorative. It absorbs the hard edges of the path and turns the light matte, green, and slow.

Move slowly. Notice one thing. Then return to the task.

Read the design rationale on GitHub.

07 Leave something at the forest gate

Quiet MCP is free. If it helped, you can support Quiet MCP.

Support is gratitude, not access control. The walk never gates on payment.