Office MCP Server

AI-Powered Office Automation - 基于 MCP 协议的 Office 文档智能处理服务

📋 项目简介

Office MCP Server 是一个基于 Model Context Protocol (MCP) 的 Office 文档自动化服务，支持通过自然语言指令操作 Word、Excel、PowerPoint 文档。

核心功能

• ✅ Word 文档处理: 创建、编辑、格式化 Word 文档
• ✅ Excel 表格处理: 数据操作、公式计算、图表生成
• ✅ PowerPoint 演示: 幻灯片创建、内容排版、样式设置
• ✅ 读写支持: 支持读取和写入现有文档（Python 方案优势）
• ✅ PDF 转换: 原生支持 PDF 生成和转换
• ✅ AI 集成: 与 Claude、Cursor 等 AI 客户端无缝集成

参考项目

本项目参考了 GongRzhe/Office-Word-MCP-Server（960+ stars）的成功实现，采用 Python + FastMCP 技术栈。

⚠️ 功能限制说明

本项目基于 Python 生态的 Office 处理库（python-docx、openpyxl、python-pptx）实现，已覆盖 85%+ 的日常办公自动化需求。但由于技术栈限制，部分 Microsoft Office 专有功能暂不支持。

Excel 功能限制

PowerPoint 功能限制

Word 功能限制

需要额外系统支持的功能

已完整支持的核心功能 ✅

尽管存在上述限制，本项目已完整实现以下功能，足以满足绝大多数办公自动化场景：

💡 使用建议

Excel 使用建议

1. 日常办公自动化：本项目完全满足需求，无需担心功能限制
2. 数据分析场景：已提供丰富的统计分析工具，可替代 Excel 的大部分分析功能
3. 复杂 VBA 宏：建议改用 Python 脚本实现，更易维护和跨平台
4. 企业级数据建模：推荐使用专业 BI 工具（如 Power BI、Tableau）或 Python 数据分析栈

PowerPoint 使用建议

1. 演示文稿创建与编辑：核心功能完整，满足日常演示需求
2. 复杂动画效果：建议在 PowerPoint 中手动添加，或使用基础动画效果
3. 多媒体内容：音频/视频需在 PowerPoint 中手动添加
4. SmartArt 图形：可使用形状组合实现类似效果
5. 批量处理：利用 Python 脚本实现批量演示文稿生成和处理
6. 内容分析：使用新增的内容提取功能分析演示文稿结构

Word 使用建议

1. 日常文档处理：核心功能完整，满足绝大多数文档创建和编辑需求
2. 文本编辑增强：使用正则表达式查找替换功能处理复杂文本模式
3. 样式管理：创建自定义样式实现文档格式统一，提高效率
4. 批量处理：利用批量操作功能处理多个文档，节省时间
5. 内容提取：使用内容提取功能分析文档结构和数据
6. 脚注与交叉引用：这些功能受限，建议在 Word 中手动添加
7. 文档保护：使用 PDF 格式或在 Word 中手动设置保护
8. 复杂域代码：基础日期时间域已支持，复杂域建议在 Word 中手动添加

📊 功能覆盖率

🚀 快速开始

前置要求

• Python: 3.10 或更高版本（推荐 3.11+）
• 操作系统: Windows 10/11, macOS 10.15+, 或 Linux
• AI 客户端: Claude Desktop, Cursor, 或其他支持 MCP 的客户端

安装步骤

方式一：使用 pip（推荐）

# 克隆仓库
git clone https://github.com/your-username/office-mcp-server.git
cd office-mcp-server

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows
venv\Scripts\activate
# macOS/Linux
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 运行服务器
python src/main.py

方式二：使用 uv（更快）

# 安装 uv
pip install uv

# 克隆仓库
git clone https://github.com/your-username/office-mcp-server.git
cd office-mcp-server

# 使用 uv 安装依赖
uv pip install -r requirements.txt

# 运行服务器
python src/main.py

方式三：使用 uvx（无需安装）

# 直接运行（如果已发布到 PyPI）
uvx office-mcp-server

🛠️ 技术栈

📦 项目结构

office-mcp-server/
├── src/
│   ├── main.py              # MCP 服务器主入口
│   ├── config.py            # 配置管理
│   ├── handlers/            # 业务处理层
│   │   ├── word_handler.py  # Word 文档处理
│   │   ├── excel_handler.py # Excel 表格处理
│   │   └── ppt_handler.py   # PowerPoint 演示处理
│   ├── tools/               # MCP 工具定义层
│   │   ├── word_tools.py    # Word MCP 工具
│   │   ├── excel_tools.py   # Excel MCP 工具
│   │   └── ppt_tools.py     # PPT MCP 工具
│   └── utils/               # 工具函数层
│       ├── file_manager.py  # 文件管理
│       └── format_helper.py # 格式化辅助
├── tests/                   # 测试目录
├── docs/                    # 文档目录
├── requirements.txt         # 依赖列表
├── pyproject.toml           # 项目配置
└── README.md                # 项目说明

⚙️ 客户端配置

Cursor 编辑器

1. 打开 MCP 设置：Ctrl+Shift+P → View: Open MCP Settings
2. 编辑配置文件（Windows: %APPDATA%\Cursor\mcp.json）

{
  "mcpServers": {
    "office-suite": {
      "command": "python",
      "args": ["C:\\path\\to\\office-mcp-server\\src\\main.py"],
      "env": {
        "PYTHONPATH": "C:\\path\\to\\office-mcp-server"
      }
    }
  }
}

Claude Desktop

编辑配置文件（Windows: %APPDATA%\Claude\claude_desktop_config.json）

{
  "mcpServers": {
    "office-suite": {
      "command": "python",
      "args": ["/path/to/office-mcp-server/src/main.py"]
    }
  }
}

使用 uvx（推荐）

{
  "mcpServers": {
    "office-suite": {
      "command": "uvx",
      "args": ["office-mcp-server"]
    }
  }
}

💡 使用示例

示例 1: 创建 Word 文档

用户指令:

请创建一个名为 "项目报告.docx" 的 Word 文档，包含标题"2024年度项目总结"。

AI 自动调用:

create_word_document(
    filename="项目报告.docx",
    title="2024年度项目总结",
    content="本报告总结了2024年度的主要项目成果。"
)

示例 2: 生成 Excel 报表

用户指令:

创建一个销售数据表格，包含产品名称和销售额，并生成柱状图。

AI 自动调用:

create_excel_workbook(filename="销售报表.xlsx")
write_excel_data(filename="销售报表.xlsx", data=[...])
create_excel_chart(filename="销售报表.xlsx", chart_type="bar", ...)

示例 3: 制作 PowerPoint 演示

用户指令:

创建一个产品介绍的 PPT，包含标题页和功能列表页。

AI 自动调用:

create_presentation(filename="产品介绍.pptx", title="新产品发布")
add_slide_with_content(filename="产品介绍.pptx", title="核心功能", content=[...])

🧪 测试

# 运行所有测试
pytest

# 运行特定测试
pytest tests/test_word.py

# 生成覆盖率报告
pytest --cov=src --cov-report=html

📚 文档

• 技术方案设计 - 完整的技术架构和实现方案
• 开发计划 - 详细的开发路线图
• 服务集成指南 - 客户端集成指南
• Word 功能说明 - Word 功能详细说明
• Excel 功能说明 - Excel 功能详细说明
• PowerPoint 功能说明 - PowerPoint 功能详细说明

🤝 贡献

欢迎贡献代码、报告问题或提出建议！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

🙏 致谢

• Anthropic - MCP 协议开发者
• GongRzhe/Office-Word-MCP-Server - 参考实现
• python-docx - Word 文档处理库
• openpyxl - Excel 表格处理库
• python-pptx - PowerPoint 演示处理库

📞 联系方式

• 项目主页: https://github.com/your-username/office-mcp-server
• 问题反馈: https://github.com/your-username/office-mcp-server/issues
• 讨论区: https://github.com/your-username/office-mcp-server/discussions

⭐ 如果这个项目对你有帮助，请给个 Star！