FreeRDC

FreeRDC

ChatGPT と Claude に、選んだフォルダーだけへのアクセスを許可します。

FreeRDC は、AI アシスタントとファイルを操作するための MCP サーバーです。許可したフォルダー内のファイルやドキュメントを読み取り、書き込み、検索、編集し、それ以外の操作はすべて拒否します。コマンドの実行、画面のクリック、マシンのシャットダウンが可能な機能は、有効にしない限りオフになっています。

デモ動画 · ウェブサイト · プライバシー · 公式 MCP レジストリに io.github.danielarif26/freerdc として掲載

FreeRDC を選ぶ理由

• まずは隔離。 許可したフォルダーの外にあるパス、.. によるパストラバーサル、シンボリックリンクによる脱出は、ファイルに触れる前に拒否されます。デバイスキーなどの保護対象パスは、ルート内であっても拒否されます。
• リスクのあるツールはオプトインです。 シェル、GUI、システムの各ツールはデフォルトで無効になっています。デスクトップ拡張機能では、ファイルとドキュメント用の23個のツールを最初から利用でき、ローカルパワーを有効にした場合のみ84個を利用できます。
• すべてのツールに説明と注釈があります。 デスクトップ拡張機能では、各ツールにタイトル、説明、入出力スキーマ、読み取り専用／破壊的／オープンワールドのヒントが設定されているため、アシスタントは実行しようとしている操作を把握できます。
• ローカルで動作します。 デスクトップ拡張機能は Mac 上で動作します。ファイルが FreeRDC のサーバーに送信されることはありません。
• 監査可能です。 すべての操作はハッシュチェーン形式の監査ログに記録され、STOP ファイルによるキルスイッチも備えています。

はじめに

Claude Desktop（デスクトップ拡張機能）

1. Releasesから freerdc-0.1.0.mcpb をダウンロードします。
2. Claude Desktop で開き、FreeRDC が使用できるフォルダーを選択します。
3. シェルまたは 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 を使用している間は、エージェントを起動したままにしてください。

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

ペアリングコードは約10分で期限切れになります。エージェントはビルド済みバイナリであり、ソースコードはこのリポジトリに含まれていません。

ソースから実行

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 のみで待ち受け、少なくとも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

セキュリティ

• シークレットは環境変数またはファイル参照に保存してください。このリポジトリ、プロファイル、シェル履歴、トンネルメタデータには決して保存しないでください。
• 脆弱性は非公開で報告してください。詳細は SECURITY.md をご覧ください。

ライセンス

AGPL-3.0-or-later の下で公開されています。Community Edition に含まれる内容については、 docs/EDITIONS.md をご覧ください。