office-tools
Enables AI assistants to read, create, edit Word/Excel/PPT files and manage the filesystem on the user's computer via natural language.
README
Office & Filesystem MCP 工具包
这是什么？
一个 MCP（Model Context Protocol）服务，装到 CherryStudio 或 Claude CLI 后，你的 AI 助手就能直接操作电脑上的文件——读取、创建、编辑 Word/Excel/PPT，以及管理文件系统。
本质上就是给 AI 装了一双能操作你电脑文件的手。
能做什么？
装好之后，你可以直接用自然语言对 AI 说：
📄 Word 文档
| 你对 AI 说 | AI 做的事 |
|---|---|
| "帮我读一下桌面的合同.docx，提取甲乙方信息和金额" | 读取 Word，解析内容 |
| "生成一份采购合同，甲方填XX公司，金额5000，保存到桌面" | 生成带格式的合同文档 |
| "把这份文档的第五条改成..." | 编辑替换指定内容 |
📊 Excel 表格
| 你对 AI 说 | AI 做的事 |
|---|---|
| "分析桌面 销售数据.xlsx 的月度趋势" | 读取 Excel 数据 |
| "把合同里的报价单提取出来，生成一个 Excel" | Word → Excel 转换 |
| "汇总这三个 Excel 的总金额，生成汇总表" | 跨文件汇总 |
🎞 PPT 演示文稿
| 你对 AI 说 | AI 做的事 |
|---|---|
| "根据这份 Word 报告生成一个 5 页的 PPT" | 报告 → 演示文稿 |
| "把这段数据做成表格放到 PPT 里" | 数据可视化 |
| "读取这个 PPT 的大纲" | 提取 PPT 结构 |
📁 文件管理
| 你对 AI 说 | AI 做的事 |
|---|---|
| "列出桌面上所有的 .docx 文件" | 浏览目录 |
| "把下载文件夹里所有 PDF 移动到一个新目录" | 批量移动 |
| "读取这个 .py 文件，帮我改第 20 行" | 编辑代码文件 |
| "帮我创建一个项目文件夹结构" | 创建目录 |
你的 AI 现在多了 14 项能力
| 类别 | 工具 | 干什么用 |
|---|---|---|
| Word | read_docx |
读取文档（段落、表格、样式） |
write_docx |
创建文档（标题、正文、表格、签署页） | |
| Excel | read_xlsx |
读取表格（多 Sheet、合并单元格） |
write_xlsx |
创建表格（表头、冻结、样式） | |
| PPT | read_pptx |
读取幻灯片（文本、表格、备注） |
write_pptx |
创建演示文稿（标题、要点、表格） | |
| 文件 | list_directory |
浏览文件夹 |
read_file |
读取任意文本文件 | |
write_file |
创建/覆盖文件 | |
edit_file |
查找替换编辑 | |
file_info |
查看文件信息 | |
create_directory |
新建文件夹 | |
move_file |
移动/重命名 | |
delete_file |
删除文件/文件夹 |
怎么装？
前提条件
- Python 3.10 或更高版本（macOS 自带，Windows 需安装）
- 已装 CherryStudio 或 Claude CLI
3 步搞定
第 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.txt
Windows:
venv\Scripts\pip install -r requirements.txt
第 3 步：配置到 AI 工具
<details> <summary>🔹 CherryStudio</summary>
设置 → MCP 服务器 → 添加：
| 配置项 | 值 |
|---|---|
| 名称 | office-tools |
| 传输类型 | stdio |
| 命令 | 选择项目目录下的 venv/bin/python |
| 参数 | server.py |
</details>
<details> <summary>🔹 Claude CLI</summary>
编辑 ~/.claude/mcp.json：
{
"mcpServers": {
"office-tools": {
"type": "stdio",
"command": "实际路径/venv/bin/python",
"args": ["实际路径/server.py"]
}
}
}
</details>
验证
"列出我桌面的文件"
返回文件列表即成功。
常见问题
Q: AI 说"无法访问桌面"？ 给完整绝对路径：/Users/xxx/Desktop/文件.docx
Q: 启动报 connection closed？ 检查 Python ≥ 3.10，确保依赖全部装完。
Q: 想加新功能？ 在 tools/ 下新建 .py，在 server.py 用 @mcp.tool() 注册。
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.