file-toolkit-mcp
v1.0.1
Published
Local file toolkit MCP server for WorkBuddy. Compress, convert and resize images; split, merge and rasterize PDFs; convert CSV/JSON/Markdown; batch rename and inspect files. 100% local processing, no uploads, no paid APIs.
Maintainers
iceman0028Readme
file-toolkit-mcp
为 WorkBuddy 连接器「文件工具箱」提供能力的 MCP 服务，包含 15 个确定性的文件处理工具。
完全在本机运行：不联网、不上传文件、不需要 API Key、不依赖任何付费服务。
工具清单
| 工具 | 作用 |
|---|---|
| image_compress | 压缩 jpg / png / webp，可按目标体积自动逼近画质 |
| image_convert | jpg / png / webp 互转，png 透明背景转 jpg 时自动铺白底 |
| image_resize | 按宽高或百分比缩放，支持只缩不放 |
| pdf_split | 逐页拆分 / 按页码提取 / 每 N 页一组 |
| pdf_merge | 按指定顺序合并多个 PDF |
| pdf_to_image | PDF 页面渲染成 png / jpg，可指定页码和 dpi |
| image_to_pdf | 一张或多张图片合成 PDF |
| json_format | JSON 美化 / 压缩 / 校验（报错会指出行列位置） |
| csv_to_json | CSV / TSV 转 JSON，自动识别 UTF-8 / GBK |
| json_to_csv | JSON 转 CSV，输出带 BOM（Excel 打开中文不乱码） |
| markdown_to_html | Markdown 转 HTML，可选完整网页或片段 |
| html_to_markdown | HTML 转 Markdown，保留表格与代码块 |
| batch_rename | 批量重命名，默认只预览，支持序号模板 |
| rename_undo | 撤销上一次批量重命名 |
| file_info | 文件大小、类型、时间、图片尺寸、PDF 页数 |
使用方式
由 WorkBuddy 连接器自动拉起，用户无需手动执行：
npx -y [email protected]也可以在任何支持 MCP 的客户端里手动配置（stdio 传输）：
{
"mcpServers": {
"file-toolkit": {
"type": "stdio",
"command": "npx",
"args": ["-y", "[email protected]"]
}
}
}输出规则
所有工具遵循同一套输出策略：
- 结果写到「第一个输入文件所在目录」下的
file-toolkit-output/文件夹 - 绝不覆盖原文件，同名时自动加序号
- 可以传文件夹，会自动收集里面的文件批量处理
- 批量处理时单个文件失败不会中断整批，结果里分别列出成功与失败
隐私
所有处理都在调用方的机器上完成。本服务不发起任何网络请求，
不读取处理目标以外的文件，也不写入 file-toolkit-output/ 以外的位置
（批量重命名会在原地改名，但会写一份可回滚的记录）。
依赖
运行时由 WorkBuddy 托管的 Node.js（>= 18.17）提供，用户端无需预装环境。
sharp（Apache-2.0）图片编解码pdf-lib（MIT）PDF 读写pdfjs-dist（Apache-2.0）+@napi-rs/canvas（MIT）PDF 光栅化marked（MIT）、turndown（MIT）文本格式转换iconv-lite（MIT）中文编码识别@modelcontextprotocol/sdk（MIT）
不含任何 AGPL / GPL 组件。
许可证
MIT