FreeRDC MCP server
Commit Nov 13, 2026Provides AI assistants with secure, sandboxed access to specific local folders for reading, writing, and searching files.
Also known as danielarif26/freerdc
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Nov 13, 2026
- License
- AGPL-3.0
What is FreeRDC MCP?
FreeRDC provides AI assistants with secure, sandboxed access to specific local folders for reading, writing, and searching files.
Summary generated from the project's README
About FreeRDC MCP server
FreeRDC provides AI assistants like Claude and ChatGPT with controlled access to specific local directories. It is designed for users who need to read, write, search, and edit files while maintaining strict security boundaries. The server prevents path traversal and symlink escapes, ensuring the assistant cannot touch any files outside of the approved folders.
For Claude Desktop users on macOS, the desktop extension offers 23 file and document tools immediately, with the option to enable 84 additional tools including shell and GUI access. ChatGPT users can connect via a self-hosted setup using the OpenAI Secure MCP Tunnel or through a hosted connector using a 10-character pairing code.
Security is a primary focus, featuring a hash-chained audit log and a STOP file kill switch to terminate operations. The system defaults to disabling risky commands, requiring manual activation for system-level tools. This setup ensures that your files remain local and are not sent to external servers during standard operations.
What you can do with it
- 1Secure file editingAsk an AI to modify documents within a specific folder without risking access to your entire hard drive.
- 2Controlled system automationEnable advanced capabilities to allow an assistant to run shell commands or interact with the GUI.
- 3Audited AI operationsMonitor every action the AI takes on your files through a secure logging system.
- 4Private ChatGPT integrationConnect your local files to ChatGPT using a secure tunnel to avoid exposing your local listener to the public internet.
Written from the project's README. Every use case is checked against a quote from it.
How to install FreeRDC MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall FreeRDC MCP in Claude Code
$ claude mcp add --transport http freerdc https://freerdc.sjaman.deno.net/mcpInstall FreeRDC MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"freerdc": {
"url": "https://freerdc.sjaman.deno.net/mcp"
}
}
}Install FreeRDC MCP in VS Code
.vscode/mcp.json
{
"servers": {
"freerdc": {
"type": "http",
"url": "https://freerdc.sjaman.deno.net/mcp"
}
}
}Install FreeRDC MCP in VS Code CLI
$ code --add-mcp '{"name":"freerdc","type":"http","url":"https://freerdc.sjaman.deno.net/mcp"}'Install FreeRDC MCP in Codex
$ codex mcp add freerdc --url https://freerdc.sjaman.deno.net/mcpInstall FreeRDC MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.freerdc] url = "https://freerdc.sjaman.deno.net/mcp"
Install FreeRDC MCP in Gemini CLI
$ gemini mcp add -s user --transport http freerdc https://freerdc.sjaman.deno.net/mcpInstall FreeRDC MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"freerdc": {
"url": "https://freerdc.sjaman.deno.net/mcp",
"type": "http"
}
}
}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 reachabledanielarif26/freerdc is public and reachablegithub.com/danielarif26/freerdc ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/danielarif26/freerdc ↗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 model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubFreeRDC
Give ChatGPT and Claude access to the folders you choose — and nothing else.
FreeRDC is an MCP server for file work with AI assistants. It reads, writes, searches and edits files and documents inside the folders you approve, and refuses everything outside them. Anything that can run commands, click the screen or shut the machine down is off unless you turn it on.
Demo video ·
Website ·
Privacy ·
Listed on the official MCP Registry as io.github.danielarif26/freerdc
Why FreeRDC
- Containment first. Paths outside your approved folders,
..traversal and symlink escapes are rejected before any file is touched. Protected paths such as device keys are denied even inside a root. - Risky tools are opt-in. Shell, GUI and system tools are disabled by default. The desktop extension exposes 23 file and document tools out of the box and 84 only when you enable local power.
- Every tool is described and annotated. In the desktop extension, each tool has a title, a description, input and output schemas, and read-only / destructive / open-world hints, so the assistant knows what it is about to do.
- Local. The desktop extension runs on your Mac. Your files are not sent to FreeRDC servers.
- Audited. Every operation is written to a hash-chained audit log, with a
STOPfile kill switch.
Get started
Claude Desktop (desktop extension)
- Download
freerdc-0.1.0.mcpbfrom Releases. - Open it with Claude Desktop and pick the folder(s) FreeRDC may use.
- Leave local power tools off unless you need shell or GUI access.
Requires macOS and Node.js 22+. Details and privacy policy:
mcpb/README.md.
ChatGPT (self-hosted)
Run the server locally and reach it privately through OpenAI Secure MCP Tunnel.
Do not expose the local listener to the public internet. See
docs/OPENAI-INTEGRATION.md and
docs/DEPLOYMENT.md.
ChatGPT hosted connector (early access)
The hosted connector is in review for the ChatGPT app directory. Until it is
listed, add it in ChatGPT developer mode with the MCP URL
https://freerdc.sjaman.deno.net/mcp.
-
Connect FreeRDC in ChatGPT. The sign-in page shows a 10-character pairing code (letters A–Z and digits 2–9).
-
Download
freerdc-agent-hosted.mjsfrom Releases. Requires Node.js 22+. -
Pair this computer, choosing the folder ChatGPT may use:
node freerdc-agent-hosted.mjs connect --server https://freerdc.sjaman.deno.net/mcp --code YOUR_CODE --device-id my-mac --root /absolute/allowed/folder -
Keep the agent running while you use FreeRDC:
node freerdc-agent-hosted.mjs run --device-id my-mac
The pairing code expires after about 10 minutes. The agent is a prebuilt binary; its source is not included in this repository.
Run from source
Requires Node.js 22+, npm and Git.
npm ci
npm run build
node packages/server/dist/src/cli.js --root /absolute/allowed/folder --port 8787
The server binds to 127.0.0.1 only, requires at least one explicit root,
stores state under ~/.freerdc, and leaves process tools disabled. Create
~/.freerdc/STOP to activate the kill switch. Pick the narrowest folder that
fits the task — never add credentials, caches or unrelated projects to a root.
Installer scripts
macOS or Linux:
curl -fsSLo install.sh https://raw.githubusercontent.com/danielarif26/freerdc/main/install.sh
sh install.sh
Windows PowerShell:
Invoke-WebRequest https://raw.githubusercontent.com/danielarif26/freerdc/main/install.ps1 -OutFile install.ps1
.\install.ps1
The installers follow the mutable main branch. For higher assurance, review a
commit or tag and pin it with FREERDC_REF=<tag-or-commit>. Rerun with
--uninstall (macOS/Linux) or -Uninstall (Windows) to remove an
installer-managed copy.
Packages
| Package | Purpose |
|---|---|
@freerdc/protocol |
Wire schemas, RPC contracts, errors, redaction, negotiation |
@freerdc/guard |
Path containment, protected-path denylist, concurrency primitives |
@freerdc/agent |
Filesystem, process policy, RPC dispatcher, authenticated connector |
@freerdc/server |
MCP tools, HTTP host, OAuth, audit log, runtime CLI |
npm run typecheck && npm run build && npm test
Security
- Secrets belong in environment variables or file references — never in this repository, profiles, shell history or tunnel metadata.
- Report vulnerabilities privately; see
SECURITY.md.
License
Released under AGPL-3.0-or-later. See
docs/EDITIONS.md for what the Community Edition includes.
FreeRDC MCP questions
How do I add FreeRDC MCP to Claude Code?
Run claude mcp add --transport http freerdc https://freerdc.sjaman.deno.net/mcp in your terminal. Add --scope user to make it available in every project.
How do I add FreeRDC MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How does FreeRDC ensure file security?
It uses containment to reject paths outside approved folders, prevents traversal and symlink escapes, and denies access to protected paths like device keys.
Can the AI run system commands or interact with my GUI?
By default, shell, GUI, and system tools are disabled. You must explicitly enable local power tools to grant this access.
Is my data sent to FreeRDC servers?
No, the desktop extension runs locally on your Mac and your files are not sent to FreeRDC servers.
How can I immediately stop all FreeRDC operations?
You can activate a kill switch by creating a file named STOP in the ~/.freerdc directory.