Quiet File Team MCP
Six free offline guidance tools for a local, file-first quiet team. They explain the method, draft a safe team config and early-exit rule, review a layout manifest, draft a fictional workflow, and batch explicit owner questions. No arbitrary file reads, no network, no paid APIs, no execution or scheduling. Free Bash core: https://github.com/pandadad0214/quiet-file-team . Optional paid setup skill on Agensi: https://agensi.io/skills/quiet-file-team-setup-kit
Documentation
Quiet File Team MCP
Give Claude, Cursor or any MCP client six free offline tools that explain, configure and check a Quiet File Team (several bots sharing one computer through files). Nothing leaves your machine: no network calls, no file reads, no paid APIs.
How to use this
uvx --from git+https://github.com/pandadad0214/quiet-file-team-mcp.git@v0.1.0 quiet-file-team-mcp
- Install uv (Python 3.11+); no token or account is needed.
- Add the server to your MCP client with the JSON below (Cursor, Claude Desktop or any stdio client).
- Ask, e.g. "Explain the quiet file team method, then draft a config for lead, builder and helper in Europe/London." Use the output with the free Bash core.
For AI agents
| Field | Value |
|---|---|
| Purpose | Offline guidance for the Quiet File Team method: explain it, draft config and early-exit text, validate a supplied layout, draft a practice workflow, batch owner questions. |
| Use when | Setting up or reviewing a file-first multi-bot team on one shared Linux machine. |
| Do not use when | You need the scripts themselves (use the Bash core), real filesystem inspection, scheduling or messaging. |
| Install | uvx --from git+https://github.com/pandadad0214/quiet-file-team-mcp.git@v0.1.0 quiet-file-team-mcp (stdio) |
| Tools | explain_method, generate_team_config, generate_early_exit, validate_layout_manifest, draft_workflow, draft_owner_batch |
| Outputs | Structured JSON per tool (output schemas included). |
| Side effects and cost | None: read-only, non-destructive, idempotent, closed-world. Free. |
Install details
uvx --from git+https://github.com/pandadad0214/quiet-file-team-mcp.git@v0.1.0 quiet-file-team-mcp
A GitHub Release also provides the wheel, source archive and checksums: https://github.com/pandadad0214/quiet-file-team-mcp/releases/latest
For Cursor, Claude Desktop or another stdio MCP client:
{"mcpServers":{"quiet-file-team":{"command":"uvx","args":["--from","git+https://github.com/pandadad0214/quiet-file-team-mcp.git@v0.1.0","quiet-file-team-mcp"]}}}
The server requires Python 3.11+ and uv on the client. It computes text from bounded supplied inputs. It does not read arbitrary files, call network APIs, execute generated shell, install software or schedule anything. No paid APIs or Actor wrapper; latency is unbenchmarked. Tool outputs are drafts, not authorization or proof of runtime safety. Not on PyPI; install from the git tag.
| Tool | Use |
|---|---|
| explain_method | Concepts and trust limits; choose before an exercise |
| generate_team_config | Review safe roster/zone defaults; lead-only coordinator |
| generate_early_exit | Draft a quoted block for a supplied role/path; outer routine must stop |
| validate_layout_manifest | Compare supplied relative paths; no actual filesystem inspection |
| draft_workflow | Fictional default-roster practice steps, not operational history |
| draft_owner_batch | Deduplicate explicit owner questions and retain unresolved task references |
All tools are read-only, non-destructive, idempotent and closed-world. Structured output schemas accompany each. Optional task summaries are not evidence of a decision; no tool sends a message. Input privacy guards are heuristic, not comprehensive secret detection.
Editions and how to switch
| Edition | Price | Where |
|---|---|---|
| Free Bash core (the scripts) | Free | quiet-file-team |
| This MCP companion (guidance only) | Free | this repo |
| Agensi setup kit skill | $29 one-time | agensi.io/skills/quiet-file-team-setup-kit |
| Apify setup kit generator (configured ZIP) | $29 per generated kit | apify.com/pandadad0214/quiet-file-team-setup |
- MCP → free core:
curl -fsSL https://github.com/pandadad0214/quiet-file-team/archive/refs/tags/v0.1.0.tar.gz | tar xz && mv quiet-file-team-0.1.0 team, setTEAM_DIR, follow its README. This MCP does not install those scripts. - Free → Agensi skill: load the skill in your agent; it guides install, rule packs and acceptance checks in your own folder.
- Free → Apify generator: fill Roster (
TEAM_IDS), IANA time zone (TEAM_TZ) and Coordinator (lead), allow a max charge of at least $29, Start, then downloadOUTPUT.zipfrom the run's key-value store into a new folder. - Paid → free: keep data backed up, use a separate clean core and repoint routines deliberately; never merge fictional logs.
For developers
python -m venv .venv
.venv/bin/pip install -e . pytest build
.venv/bin/pytest
.venv/bin/python -m build
Code is under src/quiet_file_team_mcp/server.py. Six deterministic tools use the MCP Python SDK with validated schemas and all four annotations. Runtime code has no subprocess or network client and no file-opening functions. Layout checks consume only caller-supplied path lists. MIT licensed.