内容
# 🍒 文件处理工具箱 — 用聊天的方式操作文件
> 装好后，你可以像跟同事说话一样让 AI 帮你：读 PDF、写 Word、转图片、解压文件、查看视频信息… 全部在本地完成，不联网。
---
## 🤔 这到底是什么？
简单说：**这是一个「翻译官」**。
平时你想操作文件，需要打开各种软件、点各种菜单。现在你只需要在聊天框里说「帮我把这张图转成 PNG」，AI 就会自动识别你的意思，调用合适的工具帮你完成。
> 🔰 **完全不懂技术？** 没关系。你不需要理解 MCP、stdio、JSON 这些词是什么意思。跟着下面的步骤安装，装好之后说话就行。
<details>
<summary><b>🔍 给想了解技术细节的人（点击展开）</b></summary>
这是一个基于 **MCP (Model Context Protocol)** 的工具集，包含 6 个独立 Server 共 25 个工具。MCP 是 AI 行业标准协议，让 AI 模型能够安全地调用本地程序。本项目所有 Server 遵循 MCP stdio 规范，一套部署即可在 Cherry Studio、Claude Code、Cursor、VS Code 等主流 AI 客户端中使用。
</details>
---
## 🎯 装好之后，你可以这样说话
| 你说… | 效果 |
|--------|------|
| 🗣️ 「读一下合同.pdf」 | AI 提取 PDF 全文 |
| 🗣️ 「看看报表.xlsx 的 Sheet2」 | AI 读取 Excel 数据 |
| 🗣️ 「把 photo.png 转成 JPG」 | AI 转换图片格式 |
| 🗣️ 「这首歌多长？」 | AI 显示音频时长和格式 |
| 🗣️ 「视频分辨率是多少？」 | AI 查看视频信息 |
| 🗣️ 「解压 archive.rar 到 D:\output」 | AI 解压文件 |
| 🗣️ 「帮我写一份 Word 周报」 | AI 生成 .docx 文件 |
| 🗣️ 「识别这张截图里的文字」 | AI 做 OCR 文字识别 |
> 💡 不需要记命令、不用学语法。像跟人说话一样就行。更多例子 → [📖 使用指南](docs/USAGE.md)
---
## 📦 包含的功能
| 分类 | 能做什么 | 工具数 |
|------|---------|:--:|
| 📄 **PDF** | 读取内容、查看信息（作者/页数）、从 Markdown 生成 PDF | 3 |
| 📝 **Office** | 读写 Word (.docx)、Excel (.xlsx)、PowerPoint (.pptx) | 6 |
| 🖼️ **图片** | 查看信息、格式互转、缩放裁剪、OCR 文字识别 | 4 |
| 📦 **压缩包** | 列出内容、解压（ZIP/RAR/7z/TAR）、创建压缩包 | 3 |
| 🎵 **音视频** | 查看音频/视频信息、格式转换、视频截图 | 4 |
| 🔧 **脚本工具** | 执行脚本、查看二进制文件、本地预览网页、HTML 转 PDF | 5 |
> 共 **25 个工具**，全部本地运行，无需联网。详细参数表 → [🛠 工具参考](docs/TOOLS.md)
---
## 🚀 快速开始（5 分钟）
### 第 1 步：安装依赖
```bash
pip install -r requirements.txt
```
### 第 2 步：安装系统工具（按需）
| 如果你要用… | 需要装… | 下载 |
|-------------|---------|------|
| OCR 文字识别 | Tesseract | [下载](https://github.com/UB-Mannheim/tesseract/wiki) |
| 音视频处理 | FFmpeg | [下载](https://ffmpeg.org/download.html) |
| RAR/7z 解压 | 7-Zip | [下载](https://www.7-zip.org/) |
> 只做 PDF/Office/图片/基础压缩的话，不需要装这些。
### 第 3 步：配置
打开 Cherry Studio → **设置 → MCP → 添加服务器**，参考 `cherry_mcp_config.json` 填入 6 个服务器（记得把路径改成你自己的）。
> 详细安装说明（含 macOS/Linux）→ [📥 安装指南](docs/INSTALL.md)
### 第 4 步：验证
重启 Cherry Studio，在对话中输入：
```
你能看到哪些 MCP 工具？
```
如果 AI 回复了工具列表（pdf_read, word_read, image_info…），说明成功 ✅
---
## ⚡ 快捷命令（Skills）
在 Cherry Studio 的「技能」面板中添加以下 Skill，一键触发常用操作：
| 技能名 | 触发词 | 效果 |
|--------|--------|------|
| 读 PDF | `读 PDF` | 读取并总结 PDF 内容 |
| PDF 转文本 | `PDF 转文本` | 提取 PDF 全部文字 |
| 图片信息 | `图片信息` | 查看图片尺寸和格式 |
| 批量转格式 | `批量转格式` | 文件夹内图片格式互转 |
| 解压文件 | `解压文件` | 解压压缩包到指定目录 |
| 视频信息 | `视频信息` | 查看视频分辨率和时长 |
---
## 🌐 在其他 AI 工具中使用
除了 Cherry Studio，本项目也可接入：
**Claude Code · Cursor · Continue · Windsurf · Cline · VS Code / Copilot · Claude Desktop**
每种客户端只需几行 JSON 配置。详见 → [🔌 多平台配置](docs/INTEGRATIONS.md)
---
## 📁 项目结构
```
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](LICENSE) 文件。中文摘要见 [NOTICE](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](https://github.com/ChinaPxs/cherry-studio-mcp/issues)
- ⚖️ 法律/商业授权：请通过 GitHub Issues 提交，标题注明「商业授权咨询」
