🍒 文件处理工具箱 — 用聊天的方式操作文件

装好后，你可以像跟同事说话一样让 AI 帮你：读 PDF、写 Word、转图片、解压文件、查看视频信息… 全部在本地完成，不联网。

🤔 这到底是什么？

简单说：这是一个「翻译官」。

平时你想操作文件，需要打开各种软件、点各种菜单。现在你只需要在聊天框里说「帮我把这张图转成 PNG」，AI 就会自动识别你的意思，调用合适的工具帮你完成。

🔰 完全不懂技术？ 没关系。你不需要理解 MCP、stdio、JSON 这些词是什么意思。跟着下面的步骤安装，装好之后说话就行。

这是一个基于 MCP (Model Context Protocol) 的工具集，包含 6 个独立 Server 共 25 个工具。MCP 是 AI 行业标准协议，让 AI 模型能够安全地调用本地程序。本项目所有 Server 遵循 MCP stdio 规范，一套部署即可在 Cherry Studio、Claude Code、Cursor、VS Code 等主流 AI 客户端中使用。

Related MCP server: MCP Local File Reader

🎯 装好之后，你可以这样说话

💡 不需要记命令、不用学语法。像跟人说话一样就行。更多例子 → 📖 使用指南

📦 包含的功能

共 25 个工具，全部本地运行，无需联网。详细参数表 → 🛠 工具参考

🚀 快速开始（5 分钟）

第 1 步：安装依赖

pip install -r requirements.txt

第 2 步：安装系统工具（按需）

只做 PDF/Office/图片/基础压缩的话，不需要装这些。

第 3 步：配置

打开 Cherry Studio → 设置 → MCP → 添加服务器，参考 cherry_mcp_config.json 填入 6 个服务器（记得把路径改成你自己的）。

详细安装说明（含 macOS/Linux）→ 📥 安装指南

第 4 步：验证

重启 Cherry Studio，在对话中输入：

你能看到哪些 MCP 工具？

如果 AI 回复了工具列表（pdf_read, word_read, image_info…），说明成功 ✅

⚡ 快捷命令（Skills）

在 Cherry Studio 的「技能」面板中添加以下 Skill，一键触发常用操作：

🌐 在其他 AI 工具中使用

除了 Cherry Studio，本项目也可接入：

Claude Code · Cursor · Continue · Windsurf · Cline · VS Code / Copilot · Claude Desktop

每种客户端只需几行 JSON 配置。详见 → 🔌 多平台配置

📁 项目结构

cherry-studio-mcp/
├── README.md                   ← 你正在看的
├── requirements.txt            ← Python 依赖列表
├── cherry_mcp_config.json      ← 配置模板（路径需修改）
├── servers/
│   ├── pdf_server/server.py    ← PDF 处理
│   ├── office_server/server.py ← Office 文档
│   ├── image_server/server.py  ← 图片处理
│   ├── archive_server/server.py← 压缩包
│   ├── media_server/server.py  ← 音视频
│   └── script_server/server.py ← 脚本/工具
└── docs/
    ├── USAGE.md                ← 📖 使用指南（推荐先看）
    ├── INSTALL.md              ← 📥 安装配置
    ├── INTEGRATIONS.md         ← 🔌 多平台接入
    └── TOOLS.md                ← 🛠 工具参数参考

⚖️ 法律声明与开源许可

📜 开源协议

本项目采用 Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) 许可协议。

📄 完整法律文本见 LICENSE 文件。中文摘要见 NOTICE 文件。

🛡️ 法律保护声明

╔══════════════════════════════════════════════════════════════╗
║  ⚠️ 本项目受国际版权法和 CC BY-NC 4.0 许可协议保护       ║
║                                                              ║
║  ● 版权持有人保留追究侵权行为的法律权利                     ║
║  ● 严禁任何形式的商业使用，违者将承担法律责任               ║
║  ● 商业授权需另行联系版权持有人获取书面许可                 ║
║  ● 本项目按「原样」提供，不提供任何形式的担保               ║
║  ● 用户使用本项目处理文件时，应确保拥有合法权利             ║
╚══════════════════════════════════════════════════════════════╝

📋 第三方依赖声明

本项目使用了以下开源库，各自适用其原有协议：

• PyMuPDF (AGPL/Commercial)、python-docx (MIT)、openpyxl (MIT)

• python-pptx (MIT)、Pillow (HPND)、pytesseract (Apache 2.0)

• ReportLab (BSD)、FFmpeg (LGPL/GPL)、Tesseract (Apache 2.0)

用户需自行遵守上述第三方库的许可条款。

📞 联系方式

• 🐛 技术问题：GitHub Issues

• ⚖️ 法律/商业授权：请通过 GitHub Issues 提交，标题注明「商业授权咨询」