Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@office-tools List all .docx files on my desktop"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
一个 MCP（Model Context Protocol）服务，装到 CherryStudio 或 Claude CLI 后，你的 AI 助手就能直接操作电脑上的文件——Word/Excel/PPT 三大 Office 格式的读写编辑 + PDF 解析修改 + 文件系统管理。
本质上就是给 AI 装了一双能操作你电脑文件的手。
Related MCP server: MCP Word Commander
装好之后，直接用自然语言对 AI 说：
你对 AI 说 | AI 做的事 |
"读一下桌面的合同.docx，提取甲乙方信息和金额" | 读取 Word，解析内容 |
"生成一份采购合同，甲方填XX公司，金额5000" | 生成带格式的合同文档 |
"把合同.docx 第五条金额改成 5000" | 编辑已有文档 |
你对 AI 说 | AI 做的事 |
"分析销售数据.xlsx 的月度趋势" | 读取 Excel 数据 |
"把合同报价单提取出来，生成 Excel" | Word → Excel 转换 |
"在报价单.xlsx 第 5 行后面插入一条新数据" | 编辑已有表格 |
你对 AI 说 | AI 做的事 |
"根据这份 Word 报告生成一个 5 页的 PPT" | 报告 → 演示文稿 |
"把第三页的标题改成 Q4 总结" | 编辑已有 PPT |
"给 PPT 最后加一页总结页" | 增删幻灯片 |
你对 AI 说 | AI 做的事 |
"扫描件去黄底，让纸张变白" | 智能去黄 |
"把 PDF 第 2 页的公司名改成 XXX" | 替换文本 |
"把 PDF 渲染成图片看看" | 渲染为图片供分析 |
"遮盖合同里的身份证号" | 涂黑敏感区域 |
你对 AI 说 | AI 做的事 |
"列出桌面上所有的文档" | 浏览目录 |
"把下载文件夹里所有 PDF 归档到新目录" | 批量移动 |
"读取 app.py 第 20 到 50 行" | 读取文件 |
"搜索所有 .log 文件" | 递归搜索 |
路径白名单：文件管理工具的所有路径都受白名单限制，只允许操作允许的目录内。
默认仅允许用户主目录；
用环境变量 OFFICE_TOOLS_ALLOWED_DIRS 配置多个允许的根目录（macOS/Linux 以 : 分隔）：
export OFFICE_TOOLS_ALLOWED_DIRS="$HOME/Documents:$HOME/Downloads"路径在符号链接解析后校验，无法通过软链接逃逸；禁止递归删除白名单根目录本身。
编号约定：
PDF 所有页码（page_num、page_range）统一从 1 开始，越界会明确报错；
edit_docx 的段落 index 相对于文档初始状态（与 read_docx 返回的编号一致），批量操作互不影响。
类别 | 工具 | 说明 |
Word |
| 读取文档（段落/表格/样式） |
| 创建文档（标题/正文/表格/签署页） | |
| 编辑已有文档（替换/增删段落/改表格） | |
Excel |
| 读取表格（多 Sheet/合并单元格） |
| 创建表格（表头/冻结/样式） | |
| 编辑已有表格（写值/增删行/合并/改名） | |
PPT |
| 读取幻灯片（文本/表格/大纲/备注） |
| 创建演示文稿（标题/要点/表格） | |
| 编辑已有 PPT（替换文本/改标题/增删页面） | |
| 获取 PDF 信息（页数/大小） | |
| 提取文本内容 | |
| 渲染页面为图片（供 AI 视觉分析） | |
| AI 驱动修改（自动替换/删除/添加） | |
| 保存修改后的 PDF | |
| 手动替换指定区域文本 | |
| 涂黑/涂白遮盖敏感区域 | |
| 高亮标注 | |
| 扫描件去黄底 | |
| 指定坐标添加文本 | |
文件 |
| 浏览文件夹内容 |
| 读取文本文件 | |
| 创建/覆盖写入文件 | |
| 查找替换编辑 | |
| 文件/目录详细信息 | |
| 创建目录（含父目录） | |
| 移动/重命名 | |
| 删除文件/目录 |
Python 3.10+
已装 CherryStudio 或 Claude CLI
如需 PDF 功能，系统需有中文字体（macOS/Windows 自带，Linux 可能需安装）
第 1 步：克隆项目
git clone https://github.com/xhj-cloud/office-tool.git
cd office-tool第 2 步：安装依赖
python3 -m venv venv
./venv/bin/pip install -r requirements.txtWindows:
venv\Scripts\pip install -r requirements.txt
第 3 步：配置到 AI 工具
设置 → MCP 服务器 → 添加：
配置项 | 值 |
名称 |
|
传输类型 |
|
命令 | 项目目录下的 |
参数 |
|
{ "mcpServers": { "office-tools": {
"type": "stdio",
"command": "实际路径/venv/bin/python",
"args": ["实际路径/server.py"]
}}}"列出我桌面的文件"
返回文件列表即成功。
office-tool/
├── README.md ← 本文档
├── DEPLOY.md ← 详细部署文档
├── server.py ← MCP 主程序（27 个工具）
├── requirements.txt ← Python 依赖清单
├── tools/
│ ├── word_tools.py # Word 读写编辑
│ ├── excel_tools.py # Excel 读写编辑
│ ├── ppt_tools.py # PPT 读写编辑
│ ├── pdf_processor.py # PDF 引擎（PyMuPDF）
│ ├── filesystem_tools.py # 文件系统操作
│ └── json_repair.py # JSON 自动修复
└── scripts/
├── gen_contract.py # 合同生成示例
└── github-mcp.sh # GitHub MCP 启动Q: AI 说"无法访问桌面"？ 给完整绝对路径：/Users/xxx/Desktop/文件.docx
Q: 启动报 connection closed？ 检查 Python ≥ 3.10，确保 pip install -r requirements.txt 无报错。
Q: PDF 中文乱码？ 程序自动检测系统 CJK 字体，如仍乱码请安装中文字体包。
Q: PyMuPDF 安装失败？ macOS 可尝试 brew install mupdf 后重装，Linux 需 apt install libmupdf-dev。
本项目采用 CC BY-NC 4.0（Creative Commons 署名-非商业性使用 4.0 国际）协议开源：可以自由查看、使用、修改和分发，但禁止任何商业用途。
This server cannot be deployed
Create and manage documents, spreadsheets, and presentations from your AI assistant.
An agent-first office suite Claude & ChatGPT read and write over one MCP URL.
Safe folder access for ChatGPT and Claude: read, write and search files, risky tools opt-in.
Gives your AI assistant persistent memory and intelligence about your work patterns.
