transparent-encrypt-file-mcp: Enabling Agents to Read and Write Plaintext Files in a Transparent Encryption Environment

前言

在部署了透明加密 DLP(终端数据防护)软件(ESAFENET、天锐绿盾、IP-Guard、DSE 等)的机器上,文件在磁盘上是密文,只有白名单进程打开时才被透明解密。AI Agent(WorkBuddy、Claude Code、Cursor、Cline 等)内置的 Read/Write 工具直接读文件字节,拿到的是密文:表现为文件头不对(PK/ZIP、D0CF11E0/OLE 等非标头)、正文是乱码,或带 %TSD-Header、effsoftecrypt、cdg、00005b00 等标记。Agent 不是加密软件的白名单进程,永远读不到明文。

下面介绍的 transparent-encrypt-file-mcp 解决这个问题:它提供一个 Node.js MCP Server,把读写操作委托给 DLP 白名单里的应用(Office、WPS、Outlook、AutoCAD COM,或 7-Zip、LibreOffice 命令行),让 Agent 拿到和写出的都是明文。

这是什么

  • 名称:transparent-encrypt-file-mcp
  • 坐标:@user_e98d10ee/transparent-encrypt-file-mcp
  • 版本:1.0.9
  • 来源:community(社区发布),发布者 user_e98d10ee
  • 分类:ai-agent;标签 requires_api_key=false,不需要 API Key
  • 平台:SkillHub 页面数据为评分 100000、下载 1119

定位一句话:在 Windows + 交互式桌面、且装了透明加密软件的环境下,给 AI Agent 提供一套「明文读写受 DLP 保护文件」的 MCP 工具集。

核心功能

1、按格式分派到白名单进程。Server 共提供 40 个工具,每种文件类型路由到对应进程,DLP 策略保持不变(Node/Python 直接调用 DLP 白名单内的应用):

  • Office/PDF:Office COM
  • WPS(.wps/.et/.dps):WPS COM
  • OpenDocument(.odt/.ods/.odp):LibreOffice/Word
  • RTF、邮件(.eml/.msg):Word/Outlook
  • CAD(.dwg/.dxf):AutoCAD
  • 压缩包(.zip/.rar/.7z/.tar/.gz/.tgz/.bz2):7-Zip
  • 文本与源码(.txt/.md/.csv/.json/.log/.xml/.html/.py/.js/.ts/.java/.c/.cpp/.sql/.yaml/.ini 等):fs + Word 兜底

2、能力查询:capability_matrix 工具按类型查「哪个工具能读/写哪种格式」,不用先猜再试错。

3、自检与诊断:doctor 工具做环境自检;另有一套诊断流程,用于找出哪些进程在加密软件的信任白名单里(这是该方案成立的前提)。

4、字节级取证:forensics_headers 查看文件头、inventory_encrypted 盘点受控文件、compare_plaintext 比对明文、audit_trail 输出审计记录,用来证明读到的确实是明文。

5、pywin32 补充通道(scripts/*.py):覆盖 PPT 备注、Access 行、WPS 单元格、Acrobat PDF 编辑,以及 Office 转 PDF 导出等 COM 工具不方便的场景。

6、另有 headless-safe 的 Word 读路径,适合无人值守调用。

安装与启用

该 Skill 来自社区(community),通过 SkillHub 页面获取(https://www.skillhub.cn/skills/user_e98d10ee/transparent-encrypt-file-mcp),不需要 API Key。已抓取资料中没有给出官方命令行安装命令,按 SkillHub 页面指引添加即可;MCP Server 本体是一个 Node.js 服务,需在装了透明加密软件的 Windows 交互式桌面上运行。

启用前先确认三点:

1、目标机器装的是透明加密 DLP 软件(ESAFENET、天锐绿盾、IP-Guard、DSE 之一),且 Agent 内置 Read/Write 确实只返回密文;
2、机器是 Windows,且有交互式桌面(COM 组件需要桌面会话);
3、能找到至少一个在 DLP 信任白名单里的进程(Office、WPS、Outlook、AutoCAD、7-Zip、LibreOffice 等)。

典型用法

1、先诊断:Agent 读到的文件出现 %TSD-Header、effsoftecrypt、cdg、00005b00 标记,或文件头是 PK/ZIP、D0CF11E0/OLE 但内容乱码时,先用 doctor 自检,再按诊断流程找出机器上 DLP 白名单进程。

2、查能力:不确定某格式用哪个工具时,先调 capability_matrix 查该类型的读写工具。

3、读文件:调对应的 typed reader 读取受控 Office/PDF/WPS/CAD/压缩包/文本文件,返回明文。读路径是只读的,不会保存或改动源文件。

4、写文件:调对应的 typed writer 写入受控文件。写出的内容由白名单进程重新加密,不会破坏 DLP 的加密策略。

5、取证与审计:关键读写后调 forensics_headers、compare_plaintext、audit_trail 留痕,inventory_encrypted 盘点当前目录的受控文件。

6、补充场景:PPT 备注、Access 行、WPS 单元格、Acrobat 编辑、Office 转 PDF 等走 scripts/*.py 的 pywin32 通道。

适用场景与注意

适合:Windows 交互式桌面 + 透明加密 DLP 环境;Agent 内置 Read/Write 返回密文;需要读写 .xlsx/.xls/.doc/.docx/.ppt/.pptx/.mdb/.accdb、.pdf、.wps/.et/.dps、.odt/.ods/.odp、.rtf、.eml/.msg、.dwg/.dxf、.zip/.rar/.7z/.tar/.gz/.tgz/.bz2、.txt/.md/.csv/.json/.log/.xml/.html/.py/.js/.ts/.java/.c/.cpp/.sql/.yaml/.ini 等受控文件。

不适合:

  • 没装 DLP 的机器:普通环境用 Agent 内置 Read/Write 即可,不需要这套方案;
  • 扫描件 PDF:没有 OCR,读不了图片化的 PDF;
  • 已经能直接读的文件:没有加密的环境不需要它。

注意:

  • 仅限 Windows + 交互式桌面,依赖 COM 组件和桌面会话;
  • 读路径只读、不保存源文件,写路径由白名单进程负责加密,不要绕过白名单进程直接改字节;
  • 支持的 DLP 厂商为 ESAFENET、天锐绿盾、IP-Guard、DSE;其他加密软件需先确认信任白名单。

结尾

这套 Skill 的价值在于:它不试图破解加密,而是顺着 DLP 白名单机制工作——Agent 把读写委托给加密软件认可的进程,从而拿到明文、写出后仍受控。适合部署了透明加密 DLP、又确实需要 Agent 读写文件的 Windows 桌面环境。

官方地址:https://api.skillhub.cn/user_e98d10ee/transparent-encrypt-file-mcp

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye