stdio-skill

📂 本地文件安全收发工作站

🥥49总安装量 10评分人数 11
100% 的用户推荐

基于MCP协议的本地文件中转技能,通过inbox/outbox目录实现安全文件流转,零外部依赖,适合本地文件处理工作流。

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 代码安全规范,无危险函数调用(eval/exec/system/subprocess),实现纯 Node.js 原生 API
  • ✅ 完善的路径遍历防护,通过 safeName() 严格过滤危险字符,操作严格限制在 stdio/{inbox,outbox,tmp} 目录沙箱内
  • ✅ 零外部依赖架构,无第三方 npm 包,消除供应链攻击风险,无已知 CVE 漏洞
  • ✅ 无网络通信能力,数据完全本地处理,不存在隐私泄露或远程传输风险
  • ⚠️ 来源为个人开发者账号(T3),虽当前代码审计通过,但需注意长期维护及供应链可持续性风险

使用说明

核心用法

stdio-skill 实现了一个基于 MCP(Model Context Protocol)stdio 服务器的本地文件中转系统,通过三个目录(inbox/outbox/tmp)构建简洁的文件工作流。用户将待处理文件放入 stdio/inbox/ 目录,Claude Code 通过 stdio_list 查看待处理文件,使用 stdio_read(base64)读取内容,通过 stdio_move 将文件移至 stdio/tmp/ 进行本地处理,最后利用 stdio_write 将结果输出到 stdio/outbox/。对于大文件,建议优先使用路径传递而非嵌入 base64 数据,以避免性能瓶颈。

显著优点

该 Skill 的最大优势在于其安全沙箱设计,所有文件操作被严格限制在三个指定目录内,通过 safeName()resolveInBox() 函数实现完善的路径遍历防护,彻底杜绝 ../、`
` 等危险字符的注入风险。其次,零外部依赖的架构(仅使用 Node.js 原生 fs/path 模块)消除了供应链攻击面,无已知 CVE 漏洞。此外,操作设计遵循"safe-by-default"原则,删除和覆盖操作需要显式参数确认,避免误操作。

潜在缺点与局限性

作为一款 intentionally dumb(故意设计得简单)的工具,stdio-skill 不具备文件格式解析能力,仅提供原始字节流传输,需要用户自行处理 PDF、图片等特定格式的解码工作。其次,功能范围受限,无法访问系统任意路径,仅限于工作区内的 stdio 目录,不适合需要全局文件管理的场景。此外,无网络功能,无法实现远程文件同步或云存储集成,纯本地操作模式在某些分布式工作流中可能成为瓶颈。

适合的目标群体

本 Skill 特别适合以下用户群体:与 Claude Code 进行频繁文件交换的开发者,需要在 AI 助手和本地文件系统之间建立安全桥梁的技术用户;注重数据隐私的本地工作者,由于零网络传输特性,适合处理敏感但非加密的本地文档;构建自动化工作流的工程师,可利用 inbox/outbox 模式实现类似 Unix 管道的批处理流程;以及需要在隔离环境中处理文件的安全敏感型用户,严格的目录限制提供了天然的沙箱保护。

使用风险

尽管安全评级为 A,仍需注意以下风险:首先,误删除风险虽有限制但仍存在,stdio_delete 操作不可逆,建议在 tmp 目录中保留原始备份;其次,大文件处理性能,虽然支持路径传递,但若误用 base64 传输大文件可能导致内存压力和响应延迟;第三,目录权限问题,若 stdio 目录权限设置不当可能导致读写失败;最后,T3 来源信任度,虽然代码审计通过,但作为个人开发者项目,建议在生产环境使用前进行额外审查,并关注后续更新维护情况。

stdio-skill 内容

文件夹图标scripts文件夹
手动下载zip · 4.1 kB
server.jstext/javascript
请选择文件