FreeRDC

FreeRDC

让 ChatGPT 和 Claude 访问你选择的文件夹，仅此而已。

FreeRDC 是一款供 AI 助手处理文件的 MCP 服务。它可以在你批准的文件夹内读取、写入、搜索和编辑文件及文档，并拒绝访问这些文件夹以外的所有内容。除非你主动启用，否则任何能运行命令、点击屏幕或关闭计算机的功能都会保持关闭。

演示视频 · 网站 · 隐私 · 已列入官方 MCP Registry，名称为 io.github.danielarif26/freerdc

为什么选择 FreeRDC

• 优先保障隔离。 在触及任何文件之前，就会拒绝访问已批准文件夹以外的路径、.. 路径遍历和符号链接逃逸。即使设备密钥等受保护路径位于根目录内，也会被拒绝访问。
• 高风险工具需主动启用。 Shell、GUI 和系统工具默认处于禁用状态。桌面扩展默认提供 23 个文件和文档工具；只有启用本地高级功能后，才会提供全部 84 个工具。
• 每个工具都有说明和注释。 在桌面扩展中，每个工具都包含标题、说明、输入和输出架构，以及只读／破坏性／开放世界提示，让助手知道即将执行的操作。
• 本地运行。 桌面扩展在你的 Mac 上运行。你的文件不会发送到 FreeRDC 服务器。
• 可审计。 每项操作都会写入哈希链式审计日志，并提供 STOP 文件作为终止开关。

开始使用

Claude Desktop（桌面扩展）

1. 从 Releases 下载 freerdc-0.1.0.mcpb。
2. 用 Claude Desktop 打开，并选择 FreeRDC 可使用的文件夹。
3. 除非需要访问 shell 或 GUI，否则请保持本地高级工具关闭。

需要 macOS 和 Node.js 22+。详情和隐私政策： mcpb/README.md。

ChatGPT（可自托管）

在本地运行服务，并通过 OpenAI Secure MCP Tunnel 私密访问。请勿将本地监听器暴露到公共互联网。请参阅 docs/OPENAI-INTEGRATION.md 和 docs/DEPLOYMENT.md。

ChatGPT 托管连接器（早期访问）

托管连接器正在审核中，准备上架 ChatGPT 应用目录。在正式上架之前，请在 ChatGPT 开发者模式中使用 MCP URL 添加它： https://freerdc.sjaman.deno.net/mcp。

1. 在 ChatGPT 中连接 FreeRDC。登录页面会显示一个 10 位配对码（字母 A–Z 和数字 2–9）。

2. 从 Releases 下载 freerdc-agent-hosted.mjs。 需要 Node.js 22+。

3. 配对这台计算机，并选择 ChatGPT 可使用的文件夹：

   node freerdc-agent-hosted.mjs connect --server https://freerdc.sjaman.deno.net/mcp --code YOUR_CODE --device-id my-mac --root /absolute/allowed/folder
   

4. 使用 FreeRDC 时，请保持 Agent 运行：

   node freerdc-agent-hosted.mjs run --device-id my-mac
   

配对码约 10 分钟后过期。该 Agent 是预构建的二进制文件；其源代码未包含在此仓库中。

从源代码运行

需要 Node.js 22+、npm 和 Git。

npm ci
npm run build
node packages/server/dist/src/cli.js --root /absolute/allowed/folder --port 8787

服务仅绑定到 127.0.0.1，需要至少指定一个根目录，将状态存储在 ~/.freerdc 下，并保持进程工具禁用。创建 ~/.freerdc/STOP 即可启用终止开关。请选择适合任务的最小范围文件夹——切勿将凭据、缓存或无关项目添加到根目录中。

安装脚本

macOS 或 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

安装程序使用可能变更的 main 分支。如需更高保障，请检查某个提交或标签，并使用 FREERDC_REF=<tag-or-commit> 固定版本。重新运行安装程序并添加 --uninstall（macOS/Linux）或 -Uninstall（Windows），即可移除由安装程序管理的副本。

软件包

软件包	用途
@freerdc/protocol	线路模式、RPC 契约、错误、脱敏、协商
@freerdc/guard	路径包含性检查、受保护路径拒绝列表、并发原语
@freerdc/agent	文件系统、进程策略、RPC 分发器、身份验证连接器
@freerdc/server	MCP 工具、HTTP 主机、OAuth、审计日志、运行时 CLI

npm run typecheck && npm run build && npm test

安全

• 密钥应存放在环境变量或文件引用中——切勿存放在此仓库、配置文件、Shell 历史记录或隧道元数据中。
• 请私下报告漏洞；参见 SECURITY.md。

许可证

根据 AGPL-3.0-or-later 发布。有关社区版包含的内容，请参见 docs/EDITIONS.md。