前言¶
在部署了透明加密 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