zipfs (Fuabioo)

MCP开发工具

提供方 Fuabioo

开发工具 未标注 会话登录 社区 / 第三方 Claude

zipfs是一个Go语言开发的CLI和MCP服务器,用于将zip文件作为虚拟文件系统无缝集成到AI代理中,支持透明化的zip文件内容读写和同步。

一句话选型结论

按资料字段整理

zipfs (Fuabioo) 属于开发工具类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 13 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量13暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

文件系统虚拟化Go本地部署zip文件处理AI代理工具MCP服务器开发工具

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 13 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 13 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
zipfs (Fuabioo)当前 13 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Fuabioo上游标注的维护方 Fuabioo
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

4.9 KB
来自项目仓库与上游目录的原文,未做删改

拉链

Go CLI和MCP服务器,将zip文件作为虚拟文件系统公开,以实现无缝的AI代理集成。

问题陈述

当AI编码代理(Claude Code等)需要操作zip存档中的文件(例如zip中的Excel文件)时,它们会浪费大量令牌编写即席提取/重新打包脚本。这创建了一个“令牌黑洞”,其中代理重复实现相同的zip提取逻辑。

zipfs通过在zip存档上提供透明的文件系统层来解决这个问题。代理可以像处理普通目录一样处理zip内容,而zipfs会自动处理所有提取和重新打包。

特性

  • 将zip文件作为工作区目录打开
  • 会话管理(多个拉链同时打开)
  • Tree/ls/grep覆盖zip内容
  • 读取/写入单个文件
  • 自动将更改同步回zip .bak.zip 备份
  • 用于AI代理集成的MCP服务器模式
  • 用于人工/脚本使用的CLI模式
  • 符合XDG基本目录(~/.local/share/zipfs/)
  • 通过以下方式与xlq集成(超越mcp) --basepath

快速开始

CLI示例```bash

Open a zip file

zipfs open /tmp/report.zip --name report

Browse contents

zipfs tree report
zipfs ls report/data/

Get workspace path (for tool integration)

zipfs path report

Output: ~/.local/share/zipfs/workspaces/report/contents

Use with xlq for Excel files inside the zip

xlq --basepath $(zipfs path report) head --file financials.xlsx

Sync changes back to the zip

zipfs sync report

Clean up

zipfs close report
zipfs prune # remove all workspaces


### 状态和会话管理```bash
# List all open sessions
zipfs sessions

# Check status of a specific session
zipfs status report

# Read a file from the zip
zipfs read report:data/config.json

# Write/update a file in the zip
echo "new content" | zipfs write report:data/notes.txt

# Search within zip contents
zipfs grep "pattern" report

MCP集成

zipfs可以作为MCP服务器运行,将zip文件系统操作作为AI代理可以调用的工具公开。

配置

添加到您的 claude_desktop_config.json 或 .claude/settings.json:```json
{
"mcpServers": {
"zipfs": {
"command": "zipfs",
"args": ["mcp"]
}
}
}


### 可用的MCP工具

- `zipfs_open` -将zip文件作为工作区会话打开
- `zipfs_close` -关闭工作区会话
- `zipfs_ls` -列出zip中的目录内容
- `zipfs_tree` -显示zip内容的树视图
- `zipfs_read` -从zip读取文件内容
- `zipfs_write` -在zip工作区中写入/更新文件
- `zipfs_delete` -删除工作区中的文件或目录
- `zipfs_grep` -在zip内容中搜索模式
- `zipfs_path` -获取工具集成的工作空间路径
- `zipfs_sync` -将工作区更改同步回zip
- `zipfs_sessions` -列出所有打开的会话
- `zipfs_prune` -删除过时的或所有工作区会话
- `zipfs_status` -显示提取后修改/添加/删除的文件

### MCP工作流示例```
1. zipfs_open(path="/data/reports.zip", name="reports")
-> { session_id, workspace_path, file_count }

2. zipfs_ls(session="reports")
-> { entries: ["Q4-Report.xlsx", "summary.docx", ...] }

3. zipfs_path(session="reports")
-> { path: "/home/user/.local/share/zipfs/workspaces/reports/contents" }

4. xlq_head(basepath="...", file="Q4-Report.xlsx", sheet="Revenue")
-> { rows: [...] }

5. zipfs_sync(session="reports")
-> { synced: true, backup: "/data/reports.bak.zip" }

安装```bash

go install github.com/Fuabioo/zipfs@latest


## 工作区结构

zipfs使用XDG基本目录规范进行工作区管理:```
~/.local/share/zipfs/
├── workspaces/
│   └── /
│   │   ├── contents/          # Extracted zip contents (the "mounted" filesystem)
│   │   ├── original.zip       # Copy of the original zip at open time
│   │   └── metadata.json      # Session metadata
│   └── ...
└── config.json                # Global configuration (optional)

同步时,原始zip将备份为 .bak.zip 在被覆盖之前。

用例

Zips中的Excel操作```bash

zipfs open archive.zip --name data
xlq --basepath $(zipfs path data) head --file report.xlsx --sheet Summary
xlq --basepath $(zipfs path data) write-cell --file report.xlsx --sheet Summary --cell B5 --value 42
zipfs sync data


### 管道友好型工作流```bash
zipfs open /tmp/archive.zip --name work
cat newfile.txt | zipfs write work:data/newfile.txt
zipfs read work:data/config.json | jq '.version = "2.0"' | zipfs write work:data/config.json
zipfs sync work
zipfs close work --no-sync

批处理文件更新```bash

for zip in *.zip; do
name=$(basename "$zip" .zip)
zipfs open "$zip" --name "$name"
zipfs write "$name:config.json" --content '{"updated": true}'
zipfs sync "$name"
zipfs close "$name" --no-sync
done
```

文档

看 docs/ADR/ 架构决策记录包括:

  • 项目范围和目标
  • 工作空间布局和XDG合规性
  • 会话管理生命周期
  • 同步和备份策略
  • MCP协议设计
  • CLI界面设计
  • xlq集成模式
  • 安全模型
  • Go项目结构

许可证

麻省理工学院

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
zipfs (Fuabioo) 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

zipfs (Fuabioo) 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

zipfs (Fuabioo) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

zipfs (Fuabioo) 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

zipfs (Fuabioo) 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

zipfs (Fuabioo) 能提供哪些能力?

资料显示约 13 个工具;能力标签包括 开发工具、Go、Claude、AI代理工具。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。