PC FileBridge

PC FileBridge 是一个本地 Model Context Protocol (MCP) 服务器，为 ChatGPT、Codex 及其他 MCP 客户端提供对操作员所选文件夹的受限访问。它可以读取 UTF-8 文本并创建新文件或目录，但不能覆盖、追加、重命名、移动、链接或删除。

仅创建（create-only）的保证由服务器强制执行。新文件使用操作系统独占创建模式（wx），因此如果目标已存在，将返回 TARGET_EXISTS 且保持不变。

安全属性

• 每次操作都使用配置的 root_id 和相对路径。

• 绝对路径、UNC 路径、目录穿越、备用数据流、Windows 保留名称、符号链接、联接点（junction）和重解析点逃逸均被阻止。

• 敏感文件夹和凭据文件名会被隐藏并拒绝，包括 .ssh、.aws、.azure、.codex、.git、AppData、.env*、私钥格式、PuTTY .ppk、Java 密钥库以及 SSH id_* 私钥名称。

• 文本读取仅支持 UTF-8，有字节数限制，并会脱敏常见凭据模式。

• 目录列表和文件名搜索均受限。

• 服务器没有网络客户端，也不执行 shell 命令。

• 完整驱动器根目录需要明确、具体的风险选择加入（opt-in）。

这些控制措施降低了风险，但无法确定每一份普通文档是否属于私密内容。请配置范围最窄且可用的根目录，并将返回的文件内容视为不受信任的数据。

Related MCP server: Kastor

MCP 工具

不存在删除、覆盖、追加、修补、重命名、移动、移除或取消链接（unlink）工具。

要求

• Node.js 22 或更高版本

• Windows（用于随附的 Secure MCP Tunnel 和 Task Scheduler 辅助脚本）

• 兼容 MCP 的客户端

核心服务器和策略测试也可以在 Linux 和 macOS 上运行。

安装与配置

git clone https://github.com/gexiro-global/pc-filebridge.git
Set-Location pc-filebridge
npm ci --ignore-scripts
Copy-Item .\config\roots.example.json .\config\roots.local.json

编辑 config\roots.local.json，将示例路径替换为一个或多个由您控制的文件夹。该本地文件会被 Git 忽略。

构建并验证：

npm run verify

通过 stdio 运行：

$env:FILEBRIDGE_CONFIG = (Resolve-Path .\config\roots.local.json).Path
node .\mcp\server.mjs

仓库中包含 .mcp.json 和一个 Codex 插件清单。请确保生成的 MCP 进程可以访问 FILEBRIDGE_CONFIG。如果不存在任何配置，启动时将以 CONFIG_UNAVAILABLE 安全失败（fail closed）。

ChatGPT Secure MCP Tunnel

对于 ChatGPT，请创建一个专用的 Secure MCP Tunnel 和一个专用的运行时 API 密钥。将密钥保存在仓库之外。辅助脚本期望隧道客户端位于 %LOCALAPPDATA%\PCFileBridge\bin\tunnel-client.exe，并将密钥存储在 %LOCALAPPDATA%\PCFileBridge\private\.env.local 中，且使用受限 ACL。

.\scripts\Initialize-PCFileBridgeRuntimeKey.ps1
.\scripts\Connect-PCFileBridgeTunnel.ps1 -TunnelId 'tunnel_...'
.\scripts\Get-PCFileBridgeTunnelStatus.ps1

隧道运行时必须运行在拥有已配置文件夹的计算机上。除非有独立安全的私有通道到达该 PC 上的运行时，否则远程 VPS 无法访问 PC 磁盘。

辅助程序默认使用已配置的窄范围根目录。全盘模式绝不会默认启用。

可选自动启动

成功手动连接后：

.\scripts\Install-PCFileBridgeAutostart.ps1 -TunnelId 'tunnel_...'

安装程序会创建一个新的每用户计划任务，并拒绝替换现有任务。

全盘模式

暴露整个驱动器会显著增加泄露风险。除非同时提供全盘配置和以下精确的进程变量，否则服务器会拒绝文件系统根目录：

$env:FILEBRIDGE_CONFIG = (Resolve-Path .\config\roots.full-drive.example.json).Path
$env:FILEBRIDGE_ALLOW_DRIVE_ROOT = 'I_ACCEPT_FULL_DRIVE_ACCESS_RISK'
node .\mcp\server.mjs

Windows 隧道辅助程序仅在显式以 -EnableFullDrive $true 调用时才执行相同的选择加入（opt-in）。

开发

npm ci --ignore-scripts
npm run check
npm pack --dry-run --ignore-scripts

npm run check 会执行受跟踪文件的机密扫描、类型检查、策略测试、生产构建，以及一次真实的 MCP stdio 冒烟测试；该测试要求恰好有七个工具，且零个被禁止的修改（mutation）工具。拉取请求会在 Linux 和 Windows 上运行相同的安全门禁；Windows 作业必须创建并拒绝一个真实的联接点（junction），且不能静默跳过该检查。

发布验证

正式发布版包含四个可下载文件：

• pc-filebridge-vX.Y.Z-runtime-npm.tgz

• pc-filebridge-vX.Y.Z-source.tar.gz

• pc-filebridge-vX.Y.Z-sbom.cdx.json

• SHA256SUMS

将所有文件下载到同一个空目录中，并在安装前验证哈希值。在 Windows 上：

Get-Content .\SHA256SUMS | ForEach-Object {
  $hash, $name = $_ -split '  ', 2
  if ((Get-FileHash -Algorithm SHA256 -LiteralPath $name).Hash.ToLowerInvariant() -ne $hash) {
    throw "Checksum mismatch: $name"
  }
}

GitHub 发布版还带有构建来源（build-provenance）证明。请参阅 发布验证 和 发布流程。

隐私与安全

PC FileBridge 是自托管的，且不包含任何遥测功能。通过 MCP 请求的数据会被发送到已连接的客户端，并随后受该客户端的提供商和工作区策略约束。在暴露敏感文件夹之前，请阅读 ARCHITECTURE.md、PRIVACY.md、SECURITY.md、SUPPORT.md 和 THREAT_MODEL.md。

许可证

Apache-2.0。版权所有 2026 Gexiro Global Enterprises Ltd.