Information
Office 文档处理 MCP 服务器
EN CN
MCP 服务器 Python 许可证
一个用于 Office 文档处理的 MCP(模型上下文协议)服务器,能够在不离开 AI 助手环境的情况下,在 MCP 客户端中创建和编辑 Word、Excel 和 PowerPoint 文档。
概览
Office-Editor-MCP 实现了 Model Context Protocol 标准,将 Office 文档操作作为工具和资源暴露出来。它充当 AI 助手与 Microsoft Office 文档之间的桥梁,允许您通过 AI 助手创建、编辑、格式化和分析各种 Office 文档。
功能
Word 文档操作
文档管理
使用元数据(标题、作者等)创建新的 Word 文档
提取文本内容并分析文档结构
查看文档属性和统计信息
列出目录中的可用文档
创建文档副本
内容创建
添加不同级别的标题
插入带有可选样式的段落
使用自定义数据创建表格
按比例缩放添加图片
插入分页符
文本格式化
格式化特定文本段落(加粗、斜体、下划线)
更改文本颜色和字体属性
对文本元素应用自定义样式
在整个文档中搜索和替换文本
Excel 操作
工作簿管理
创建新的 Excel 工作簿
打开现有的 Excel 文件
添加/删除/重命名工作表
数据处理
读取和写入单元格内容
插入/删除行和列
排序和筛选数据
应用公式和函数
PowerPoint 操作
演示文稿管理
创建新的 PowerPoint 演示文稿
添加/删除/重新排列幻灯片
设置幻灯片主题和背景
内容编辑
添加文本和图形元素
插入表格和图表
添加动画和过渡效果
高级功能
OCR 识别(从图像中提取文本)
文档比较(比较文档之间的差异)
文档翻译
文档加密和解密
表格数据导入/导出(数据库交互)
安装指南
先决条件
Python 3.7 或更高版本
pip 包管理器
Microsoft Office 或兼容组件(如 python-docx, openpyxl)
基本安装
bash
克隆仓库
git clone https://github.com/theWDY/office-editor-mcp.git
cd office-editor-mcp
安装依赖
pip install -r requirements.txt
配置
在 Cursor 中配置
方法 1:UI 配置
打开 Cursor
转到 设置 > 功能 > MCP
点击 "+ 添加新的 MCP 服务器"
填写配置信息:
名称:Office 助手(可根据需要修改)
类型:选择 stdio
命令:输入运行服务器的完整路径,例如:
python /path/to/office_server.py
注意:请替换为您的实际文件路径
方法 2:JSON 配置文件(推荐)
在项目目录中创建 .cursor 文件夹(如果不存在)
在该文件夹中创建 mcp.json 文件,并包含以下内容:
json
\{
"mcpServers": \{
"office-assistant": \{
"command": "python",
"args": ["/path/to/office_server.py"],
"env": \{\}
\}
\}
\}
在 Claude for Desktop 中配置
编辑 Claude 配置文件:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
添加以下配置:
json
\{
"mcpServers": \{
"office-document-server": \{
"command": "python",
"args": [
"/path/to/office_server.py"
]
\}
\}
\}
重启 Claude 以应用配置。
使用示例
配置完成后,您可以向 AI 助手发出如下命令:
Word 文档操作
"创建一个名为 'quarterly_report.docx' 的新文档,并添加封面页"
"向文档中添加一个标题和三个段落"
"插入一个 4x4 的销售数据表格"
"将第 2 段中的 'important' 一词加粗并设为红色"
"搜索并替换所有 'old term' 为 'new term'"
Excel 操作
"创建一个名为 'financial_analysis.xlsx' 的新 Excel 工作簿"
"在 A1 单元格中插入 '季度销售' 作为标题"
"创建一个包含部门销售数据的表格并计算总和"创建销售数据的条形图
按降序对B列中的数据进行排序
PowerPoint 操作
创建名为 'project_presentation.pptx' 的演示文稿
添加标题为 'Project Overview' 的新幻灯片
在第2张幻灯片中插入公司徽标
为标题添加飞入动画
API 参考
Word 文档操作
文档创建和属性
create_document(filename, title=None, author=None)
get_document_info(filename)
get_document_text(filename)
get_document_outline(filename)
list_available_documents(directory=".")
copy_document(source_filename, destination_filename=None)
内容添加
add_heading(filename, text, level=1)
add_paragraph(filename, text, style=None)
add_table(filename, rows, cols, data=None)
add_picture(filename, image_path, width=None)
add_page_break(filename)
文本格式化
format_text(filename, paragraph_index, start_pos, end_pos, bold=None,
italic=None, underline=None, color=None, font_size=None, font_name=None)
search_and_replace(filename, find_text, replace_text)
delete_paragraph(filename, paragraph_index)
create_custom_style(filename, style_name, bold=None, italic=None,
font_size=None, font_name=None, color=None, base_style=None)
Excel 操作
工作簿操作
create_workbook(filename)
open_workbook(filename)
save_workbook(filename, new_filename=None)
add_worksheet(filename, sheet_name=None)
list_worksheets(filename)
单元格操作
read_cell(filename, sheet_name, cell_reference)
write_cell(filename, sheet_name, cell_reference, value)
format_cell(filename, sheet_name, cell_reference, **format_args)
PowerPoint 操作
演示文稿操作
create_presentation(filename)
open_presentation(filename)
save_presentation(filename, new_filename=None)
add_slide(filename, layout=None)
故障排除
常见问题
缺少样式
某些文档可能缺少用于标题和表格操作所需的样式
服务器将尝试创建缺失的样式或使用直接格式化
为了获得最佳效果,请使用带有标准 Office 样式的模板
权限问题
确保服务器具有读取/写入文档路径的权限
使用 copy_document 函数为锁定的文档创建可编辑副本
如果操作失败,请检查文件所有权和权限
图像插入问题
使用绝对路径指定图像文件
验证图像格式兼容性(推荐使用 JPEG、PNG)
检查图像文件大小和权限
调试
通过设置环境变量启用详细日志记录:
export MCP_DEBUG=1 # Linux/macOS
set MCP_DEBUG=1 # Windows
实现进度
✅ 构建 MCP 服务器基本框架
✅ 成功与 AI 助手集成
✅ 基本 Word 文档操作
✅ 基本 Excel 工作簿操作
✅ 基本 PowerPoint 演示文稿操作
✅ 高级功能增强
✅ 性能优化
✅ 跨平台兼容性测试
贡献
欢迎贡献!请随时提交 Pull Request。
分叉仓库
创建你的特性分支 (git checkout -b feature/amazing-feature)
提交更改 (git commit -m 'Add some amazing feature')
推送到分支 (git push origin feature/amazing-feature)
打开 Pull Request
许可证
此项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。
致谢
Model Context Protocol 用于协议规范
python-docx 用于 Word 文档处理
openpyxl 用于 Excel 处理
python-pptx 用于 PowerPoint 处理
注意:此服务器会与系统上的文档文件交互。在 AI 助手或其他 MCP 客户端中确认请求的操作之前,请始终验证这些操作是否适当。