FolderBridge MCP server
Commit Oct 22, 2026Provides a secure, local-first bridge that lets AI clients inspect and edit specific local folders through a desktop launcher.
Also known as MoonTzai/folderbridge-mcp
- Stars
- 2
- Tools
- 9
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 22, 2026
- License
- Apache-2.0
What is FolderBridge MCP?
FolderBridge provides a secure, local-first bridge that lets AI clients inspect and edit specific local folders through a desktop launcher. It exposes 9 tools, such as server_info, flight_recorder, workspace.
Summary generated from the project's README
About FolderBridge MCP server
Allowing AI clients to interact with specific local directories through a secure, local-first bridge is what FolderBridge MCP accomplishes. It provides a desktop launcher for Windows that enables web-based clients like ChatGPT to inspect and edit a bounded set of folders you explicitly choose. This setup avoids public HTTP servers and arbitrary shell access, focusing instead on a controlled workspace that minimizes the attack surface.
Users can extend the server's capabilities without rebuilding the core executable by adding external Extensions or Skill Packs. Extensions provide executable integrations like the Blender Toolkit for 3D scene control, the FFmpeg Toolkit for media processing, or the Git Publisher for managing GitHub repositories. Skill Packs offer domain knowledge and production workflows, such as the Video Storyboard Production pack, to guide how an AI agent approaches specific tasks. The system uses a stable tool catalog and requires hash-based approval for any new plugin to ensure security and prevent unauthorized changes to executable behavior.
What you can do with it
- 1Manage local media filesAn AI agent can use the FFmpeg Toolkit to probe media files and execute long-running media jobs within a workspace.
- 2Automate 3D scene editingYou can instruct an AI to control Blender scenes, objects, and animations through a dedicated toolkit.
- 3Publish code to GitHubA developer can have an AI perform exact-file commits and push changes to a repository.
- 4Execute complex video workflowsAn AI can follow specific narration-first methods to plan and orchestrate video production.
Written from the project's README. Every use case is checked against a quote from it.
FolderBridge MCP tools 9
Detected from the READMEserver_infoflight_recorderworkspacefile_infopptx_inspectimage_openextensionedit_filewrite_file
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablemoontzai/folderbridge-mcp is public and reachablegithub.com/moontzai/folderbridge-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-22github.com/moontzai/folderbridge-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model9 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubFolderBridge MCP
简体中文 | English
[!TIP] FolderBridge itself is a single-file Windows app: download
FolderBridge-Windows-x64.exedirectly and double-click it. No Python or Node.js installation is required. The binary is under GitHub Releases → latest release → Assets; it does not appear in the repository's source-file list. For ChatGPT on the web, FolderBridge still uses OpenAI's separately distributed officialtunnel-client.exe; the launcher guides you through selecting it. The full release page clearly separates the main Windows program from optional Plugin ZIPs and includes a short description for each asset; SHA sidecars are verified during build/CI but are not published as Release assets.
A safer, local-first bridge between AI clients and a small set of folders you explicitly choose.
FolderBridge MCP is a zero-dependency Python MCP server plus a desktop launcher. It lets ChatGPT on the web—or any client that supports local stdio MCP—inspect and carefully edit a bounded local workspace. It deliberately avoids a public HTTP server, arbitrary shell access, telemetry, and silent background services. The Windows launcher can switch the complete user-facing interface between Chinese and English with the persistent 中文 / EN button immediately to the left of the connection guide; changing language does not reconfigure or reconnect the Tunnel.
[!IMPORTANT] This project is in an early public beta. It reduces the attack surface; it is not an operating-system sandbox. Only expose folders and repositories you trust.
Extend FolderBridge without rebuilding it
FolderBridge is designed to keep a stable MCP tool catalog while still allowing local capabilities to grow freely. You can add or update an external Extension, rescan it, approve its exact hash and declared permissions, and use its actions through the stable extension gateway without rebuilding FolderBridge.exe or registering a new MCP tool name. External Extensions are hot-scanned and executed out of process; changing their hash-covered files makes the previous approval stale instead of silently changing executable behavior.
Skill Packs provide a second extension axis for methods, domain knowledge, review rubrics, and production workflows rather than executable integrations. They are discovered and routed through the bundled read-only skill-engine; external packs are exact-hash approved, their text is loaded on demand, and adding a Pack does not expand the MCP schema. This makes it possible to customize both what FolderBridge can do and how an AI agent should approach the work.
Current public external plugins
| Plugin | Version | What it adds |
|---|---|---|
Blender Toolkit (blender-toolkit) |
0.1.2 | Bounded Blender 5.x scene, object, node, animation, render, import/export, and GUI-control bridge. |
ChatGPT Web LLM Adapter (chatgpt-web-llm-adapter) |
0.3.2 | Test-only fresh-chat local LLM bridge with Launcher-owned lifecycle, strict JSON-object mode, per-run credentials, bounded concurrency, plus history-safe fresh-chat cadence/window throttling and cooldown. |
Local ComfyUI (comfyui) |
1.6.0 | Local ComfyUI workflow Jobs, health/progress, model/node discovery, targeted cancellation, memory release, and production preflight profiles. |
Download Toolkit (download-toolkit) |
0.1.0 | Public HTTPS downloads and safe GitHub source snapshots with streamed size/hash verification and SSRF/redirect defenses. |
FFmpeg Toolkit (ffmpeg-toolkit) |
0.1.2 | Workspace-confined FFmpeg/FFprobe probing, capability discovery, and long-running media jobs. |
FTP Toolkit (ftp-toolkit) |
0.2.1 | Workspace-confined FTP/FTPS profiles, listing/stat, upload/download, recursive upload, rename, mkdir, and exact-file delete. |
Godot AI Local Bridge (godot-ai) |
0.1.0 | Bounded local Godot editor, scene, run, log, screenshot, and runtime-input actions. |
Git Publisher (git-publisher) |
1.6.0 | Optional hot-updatable GitHub creation, exact-file commit/push and Release publishing with browser-backed Git Credential Manager. |
Local GPT-SoVITS (gpt-sovits-local) |
0.2.2 | Full local v2Pro toolkit for reference/audio prep, ASR, dataset preparation, training, batch inference, and WebUI/API lifecycle. |
PDF Toolkit (pdf-toolkit) |
0.6.0 | Bounded PDF inspection, text search, outline reading, and parser-independent page rendering. |
Storyboard ChatGPT Web (storyboard-chatgpt-web) |
0.2.0 | ChatGPT Web native storyboard image generation/editing with GENERATE_ONLY or an independent native Visual Judge, exact image/provenance recovery, and PASS-only canonical acceptance. |
Windows Capture Toolkit (windows-capture-toolkit) |
0.1.3 | Bounded one-shot Windows screenshots plus exact-window left-click automation, without keyboard/macro or DRM-bypass surfaces. |
The public source and installation layout is under Plugins/extensions/. Extensions are ordinary local plugin directories with a manifest and declared entrypoint, so users can build their own integrations against the documented Extension ABI instead of waiting for FolderBridge Core to add every tool.
Current public external Skill Packs
| Skill Pack | Version | What it adds |
|---|---|---|
FolderBridge Project Discipline (folderbridge-discipline) |
1.0.0 | Four reusable methods for local-project execution discipline, large-file workflows, source-of-truth control, and runtime verification. |
Video Storyboard Production (video-storyboard-production) |
1.0.0 | Six narration-first AI-video methods covering continuity, storyboard design, shot specification, MiniMax H3/ComfyUI planning, orchestration, and generated-video review. |
Public Pack source lives under Plugins/skill-packs/. A custom Pack can add project-specific methodology without receiving executable permissions, while an Extension is the right mechanism when the integration needs bounded local actions or external-process/API access.
0.8.40 highlights
- Lifecycle truth is now self-describing:
server_inforeportstool_surfacepluscontinuity.runtime_state,catalog_revision,diagnostics_available, and the SHA-256 of the actual MCP tool catalog. Execution binding mismatches raiseTOOL_SURFACE_BINDING_FAILUREinstead of relying on capability declarations alone. - Windows packaging now proves the real EXE surface: the bundle verifier launches the newly built executable and checks
initialize → tools/list → server_info, including exact tool-name/count/hash agreement andrun_capability/run_taskexposure before packaging can pass. - Version identity is advanced to 0.8.40: this prevents an older 0.8.39 runtime from being mistaken for the lifecycle-resilience candidate merely because both report the same semantic version.
0.8.39 highlights
server_infono longer goes blind when one workspace breaks: a workspace removed or made unavailable after startup is isolated to that workspace instead of crashing the whole server summary. Healthy workspaces continue to report normally.- Actionable diagnostics instead of a bare
FileNotFoundError: each workspace now exposesavailableand boundeddiagnostics; top-levelhealthy/issuesidentify the failing scope, stage, code, exception type, and affected path. Missing roots reportWORKSPACE_ROOT_MISSINGdirectly. - Failure evidence is preserved:
server_infoissues are recorded as warning events in the Flight Recorder without storing full local paths, while startup-time workspace validation names missing/inaccessible paths directly. Regression coverage locks the runtime-removal, global-summary-failure, and pre-start missing-root cases.
0.8.38 highlights
- Public plugin source/Release alignment: the public external Extension catalog is now 11 plugins.
storyboard-chatgpt-web 0.2.0andwindows-capture-toolkit 0.1.3join the repository/Release surface alongside the already-public ChatGPT Web LLM Adapter; curated Releases contain one Windows executable plus 11 Plugin ZIPs, while SHA sidecars remain CI-only and the private Debate Judge adapter remains excluded. - No stale LLM Bridge credentials after Restart: the Launcher now removes the previous Standalone
status.htmlbefore starting a new owned generation, then refuses to open any status page whose embedded temporary API key does not match the current live connection record. This closes a live-observed race where the sidebar could already show the new one-run key while an older browser tab still displayed the previous key. - Fresh status-page navigation: status-page opening now uses a cache-busted
file://URL in a new browser tab, preventing normal browser page reuse from preserving an old in-memory document after the Standalone has generated a new key. The host correction itself did not require plugin reapproval. - Adapter 0.3.2 history-safe throttling: fresh ChatGPT page creation is now separately paced (20-second minimum start interval, at most 8 starts per rolling 5 minutes), known conversation-history rate-limit warnings trigger 2/4/8/10-minute exponential cooldown, and login/verification reuses an existing ChatGPT page when possible. Temporary Chat is not silently claimed or enforced until the web control can be verified reliably.
- Adapter 0.3.1 strict-JSON wrapper hardening: browser extraction now removes assistant-message UI controls before reading response text, and harmless
json/Copy codedisplay labels may be joined on one line without causing a false 502. Semantic prose, arrays, multiple objects and malformed JSON remain rejected.
0.8.37 highlights
- One-click ChatGPT Web LLM Bridge control: the Extensions & Skills sidebar can now manage the external
chatgpt-web-llm-adapteras a Launcher-owned service with explicitOFFLINE / STARTING / WAITING_LOGIN / READY / ERRORstate, Start/Restart/Stop, separate status/login-page controls, a real one-click JSON completion validation (LIVE_PROBE_PASS), Base URL / model / one-run API-key copy fields, active/max request visibility, and a bounded 1–4 concurrency slider (default 2). Normal use no longer needs the Standalone start/status/validation/stop CMD files. - Ownership stays safe: FolderBridge only stops the Standalone process tree it created and still holds by process handle. Busy 8769/8770 ports from unknown/external processes fail closed; the Launcher never discovers a PID by port and never kills an unfamiliar process to make the service start.
- Adapter 0.3.0 version truth: the installed Extension version/hash, live Adapter version, and status page version are separate visible axes.
/healthand the one-run connection record carry the live adapter version; a mismatched old process is shown asERROR, never as READY. The temporary bearer stays on the local human control plane and is no longer returned by Extensionstatus/connectionactions. - Formal public package:
chatgpt-web-llm-adapteris now the ninth public external Extension. Its Release ZIP is built from an explicit seven-file allowlist, verified member-for-member after compression, and intentionally excludes local HANDOFF/CLOSURE material. - No-CMD external plugin updates: Extensions & Skills now has Install/update plugin ZIP…. The installer stages and validates an external Extension ZIP, rejects traversal/links/encryption/case collisions/oversized expansion and bundled-ID shadowing, safely stops only a Launcher-owned managed service before replacement, and never carries approval across a changed exact hash.
0.8.36 highlights
- Truthful green health state: the launcher no longer stays yellow after a genuinely successful ChatGPT/Tunnel call. Each Tunnel generation injects a fresh nonce into its private stdio MCP child, and only a successful
tools/callcarrying that exact generation nonce can promote the status to End-to-end healthy. Process-alive and local child probes still cannot create a false green state, and stale evidence from another generation is rejected. - Interactive update links: update-check results now show the Latest Release URL in a selectable field with Ctrl+C support, double-click/Enter open behavior, plus explicit Open release page and Copy link buttons.
0.8.35 highlights
- Curated GitHub Releases: the latest Release now exposes one clearly named main program (
FolderBridge-Windows-x64.exe) plus eight optional public Plugin ZIPs using theFolderBridge-Plugin-…-v….zipconvention. GitHub display labels identify each asset as the main program or a plugin and add a one-line purpose description. SHA-256 sidecars remain an internal build/CI integrity check and are no longer published as Release assets. - Release hygiene: the release workflow removes historical
.sha256assets and retiredfile-ops-toolkitassets. The public plugin allowlist remains eight extensions, and the retired File Ops implementation stays out of the public tree and Release surface. - Extensibility showcase: the README now treats hot-loadable external Extensions and exact-hash Skill Packs as first-class capabilities, with the current public plugin/Skill catalog and their roles documented up front.
- Core File Ops live acceptance: one real Test file was copied and moved both within
folderbridge-mcpand acrossfolderbridge-mcp → Tools; every destination preserved the exact SHA-256, same-workspace move usedatomic-move, and cross-workspace move usedverified-copy-delete.
0.8.34 highlights
- Core cross-workspace file operations:
file_opsis now a built-in FolderBridge tool for bounded regular-file copy/move within one selected workspace or between two explicitly selected workspaces. Both endpoints stay workspace-confined; no-clobber is the default; overwrite is SHA-guarded; cross-workspace move uses verified copy → destination hash/size verification → source stability recheck → source removal. The former external File Ops Toolkit is no longer published for new installs, while existing local installations remain untouched for staged disable → Core acceptance → final removal. - Update checking: the Windows launcher checks GitHub Releases asynchronously after startup and also exposes a manual Check for updates button. Only a newer semantic version triggers an update prompt, which shows and can open
https://github.com/MoonTzai/folderbridge-mcp/releases/latest; network failures never block local startup or MCP operation.
0.8.26 highlights
- Much larger bounded MCP framing: production stdio and the private Phase-0 ingress now share a 32 MiB request ceiling, transactional writes use 4 MiB chunks, exact edits remain 128 MiB, and whole-file transactional writes/literal search retain their larger independent limits.
- Oversized requests fail in isolation: request-correlated oversize handling and bounded drain/reframe logic prevent one over-ceiling request from turning into the previous shared-stdio global-runtime drop pattern.
- Runtime API Key paste cleanup: leading/trailing spaces, tabs and CR/LF are removed immediately from the in-memory launcher field and normalized again before connect/apply/diagnose; inherited
CONTROL_PLANE_API_KEYvalues follow the same rule and credentials are still never persisted. - External Blender Toolkit 0.1.1: the repository now ships the exact-hash-approved Blender bridge source/installer, including Blender 5.x compositor migration compatibility and live node/data/render/animation operations used by deterministic video-control workflows.
- Video Storyboard Production Skill Pack 1.0.0: optional local methodology skills cover narration-to-storyboard planning, continuity inventory, shot specification, MiniMax H3 workflow design, and generated-video review.
FolderBridge MCP questions
What tools does FolderBridge MCP provide?
It exposes 9 tools, including server_info, flight_recorder, workspace, file_info, pptx_inspect.
Do I need to install Python or Node.js to use FolderBridge?
No, the Windows app is a single-file executable that requires no Python or Node.js installation.
Is FolderBridge a secure sandbox for my operating system?
No, while it reduces the attack surface by limiting access to explicitly chosen folders, it is not an operating-system sandbox.
Can I add new capabilities to FolderBridge without rebuilding the main application?
Yes, you can add external Extensions and Skill Packs that are hot-scanned and executed out of process.