让 Claude Code 帮你压缩和转换文件（MCP）

让你的 AI 助手用真正的工具处理文件，而不是它当场现编的脚本。1FileTool 的 AI Access 把 64 个操作——压缩、转换、提取、遮盖——以 MCP server 的形式开放出来，Claude Code 或 Gemini 都能调用，而所有文件都留在你的电脑上。

$ claude
Claude Code v2.x

> Compress every image in ~/Desktop/sample-photos and put the results in
  ~/Desktop/sample-photos/compressed

● I'll use the 1FileTool MCP bridge running on this Mac.

● filetool_compress_images(paths: ["~/Desktop/sample-photos"], quality: 82,
    output_dir: "~/Desktop/sample-photos/compressed")
  ⎿  Compressed 12 images
     38.2 MB → 6.9 MB (saved 81.9%)
     Results in ~/Desktop/sample-photos/compressed

● Done — 12 images compressed from 38.2 MB to 6.9 MB. The originals are
  untouched; the compressed copies are in the compressed/ subfolder.

Note: MCP runs count toward the daily total — 12 files exceeds the free
tier's 8 files/day, so a batch this size needs Pro.

上面的截图是一次真实的 Claude Code 会话：一句大白话指令、一次 filetool_compress_images 调用，十二张图片从 38.2 MB 缩到 6.9 MB。

你需要什么

• 1FileTool 1.10.0 或更高版本，装在 macOS（Apple Silicon 或 Intel）、Windows 或 Linux 上。
• 同一台机器上装有 Claude Code 或 Gemini CLI。一键接入只覆盖这两个客户端。
• 助手本身需要联网——你的文件不会离开本机，但 AI CLI 要和自己的云端模型对话。

ZIP 里有五张合成的 JPG 照片（hero-photo.jpg、team-photo.jpg、product-shot.jpg、banner.jpg、cover.jpg）——一个可以安全指给助手处理的图片文件夹。

那条警告是针对应用界面的——通过 MCP 调用时，像 filetool_compress_images 这样的操作会把 *_compressed 副本写进输出文件夹，原文件保持不动。还要记住：agent 运行是按文件逐个计数的，计入免费版每天 8 个文件的额度，所以 12 个文件一批需要 Pro 或者换一个更小的文件夹。

步骤

1. 打开 AI Access 设置

启动 1FileTool，打开 Settings，点 AI Access 标签，选择 MCP 区块。

2. 打开 AI 访问开关

拨动 Allow AI assistant access。状态徽章会变成 Listening，文案会把边界写得很清楚："Accepting local requests on 127.0.0.1:<port>. Nothing is exposed to the network."。这个桥接只走 loopback，并用每次启动生成的 token——没有对外开放的端口、不需要账号、没有上传。

3. 连接你的 CLI

点击 Connect。1FileTool 会把自己注册为 onefiletool MCP server，写进它找到的每一个受支持客户端：

• Claude Code——写入 ~/.claude.json
• Gemini CLI——合并进 ~/.gemini/settings.json

每个客户端都有徽章（"Claude Code"、"Gemini CLI"），没安装的会标 "— not found"。确认信息写着 "Connected. Restart Claude Code to pick up the new tools."——重启你的 CLI 让它加载这个 server。

用的是别的客户端？Set up another client manually 会展开一个可以直接粘贴的配置块。

4. 用大白话派活

在 Claude Code 或 Gemini 会话里直接用日常语言说就行——设置页给出了建议说法：

use 1filetool mcp to compress these images

指向一个文件夹——解压示例 ZIP，然后试试 "use 1filetool mcp to compress the images in this folder"。助手会挑选正确的 filetool_* 操作，任务通过 1FileTool 在本地跑，结果落到你的输出文件夹。

结果

让助手压缩示例文件夹后，它会运行 filetool_compress_images，*_compressed.jpg 副本出现在 ~/Documents/1FileTool——或者你设置的任何输出文件夹里。原文件原封不动。

压缩之外，你的助手还能调用 64 个操作——filetool_list_operations 会把它们列出来：图片（12）、PDF（20）、视频（9）、音频（7）、文件与数据（6）、隐私（4）、设备端 AI（4），外加检查和状态类。其中两个操作需要 Pro，其余共用应用的免费每日额度。

如果不管用

• CLI 看不到任何工具。 点过 Connect 之后重启它——server 写进了配置，但只有新启动的会话才会加载。
• 工具输出里出现 "PRO_REQUIRED"。 有两个操作——auto-redact 和 watch-folder 自动化——是 Pro 专属。助手会收到这个提示并转告你。
• "Daily free limit reached"。 agent 运行按文件数而不是按 prompt 计数，一批 12 张图就可能吃光 8 个文件的免费额度。明天重置；Pro 解除上限。
• 1FileTool 没在运行。 MCP server 是通往应用的桥——应用关着的话，助手的调用无处可去。
• Codex 配置。 UI 里有 Codex 那一行，但自动接入写的文件 Codex 并不读——用配置块手动配置那个客户端，或者用 Claude Code 或 Gemini。

接下来试试

在浏览器里直接体验助手调用的那个压缩操作：

相关内容

• AI Access 与 MCP 参考
• Free vs Pro
• 安装 1FileTool
• Compress Images 和 Compress Video