关键词

文档处理Office助手Word编辑Excel编辑自动化办公

Office 文档助手 MCP 服务器使用说明

项目简介

这是一个基于模型上下文协议 (MCP) 的服务器应用，旨在将 Microsoft Office 文档（目前主要支持 Word 和 Excel）的处理能力集成到支持 MCP 的客户端（如 Cursor、Claude Desktop 等）中。用户可以直接在客户端环境中使用自然语言或命令来创建、编辑和管理 Office 文档，无需切换应用程序。

主要功能点

  • Word 文档操作:
    • 创建、打开、保存 (.docx, .pdf 等格式) Word 文档。
    • 添加、编辑、删除文本内容和标题。
    • 设置文本格式（字体、大小、颜色、加粗、斜体、下划线、高亮等）。
    • 设置段落格式（对齐、缩进、行距、段间距）。
    • 插入图片、表格，并编辑表格内容。
    • 插入和更新目录（需 Word 应用配合）。
    • 添加页眉页脚、设置页码。
    • 设置页面布局（纸张大小、页边距、方向）。
    • 查找和替换文本。
    • 合并多个 Word 文档。
  • Excel 文档操作:
    • 创建、打开、保存 (.xlsx, .xls, .csv 等格式) Excel 工作簿。
    • 添加、删除、重命名工作表。
    • 读取、写入、清除单元格内容。
    • 设置单元格格式（字体、颜色、背景、对齐、边框）。
    • 合并/拆分单元格。
    • 插入/删除行和列。
    • 数据排序、筛选（应用筛选器）。
    • 应用公式（SUM, AVERAGE, COUNT, IF, VLOOKUP 等）。
    • 批量填充、批量替换。
    • 创建图表（柱状图、折线图、饼图、条形图）。
    • 创建和更新数据透视表（结构创建，需 Excel 刷新数据）。
    • 设置数据有效性（如数字范围、列表下拉框）。
    • 添加条件格式（如单元格值、色阶、数据条）。
  • 通用功能:
    • 支持通过环境变量 'OFFICE_EDIT_PATH' 自定义文件操作的基础路径（默认为用户桌面）。

安装步骤

  1. 环境准备:
    • 确保您的计算机上安装了 Python 3.7 或更高版本。
    • 确保您的计算机上安装了 Microsoft Office 或兼容的组件（部分高级功能如 PDF 导出、特定格式保存、目录/页眉页脚操作、数据透视表刷新等依赖 Office COM 组件，因此在 Windows 系统上体验更完整）。
  2. 下载代码: 克隆或下载此 GitHub 仓库到您的本地计算机。
  3. 安装依赖: 打开终端或命令行，进入仓库目录，运行以下命令安装所需的 Python 库： 
    pip install mcp-python-sdk python-docx openpyxl pandas numpy Pillow pywin32
    • 'mcp-python-sdk': MCP 服务器核心库。
    • 'python-docx': 用于处理 Word 文档 (.docx)。
    • 'openpyxl': 用于处理 Excel 文档 (.xlsx)。
    • 'pandas', 'numpy': 用于 Excel 的数据处理功能（如排序）。
    • 'Pillow': 用于处理图片（如图插入）。
    • 'pywin32': (仅限 Windows) 提供与 Office COM 组件交互的能力，用于实现一些高级功能（如 PDF 导出、另存为 .doc/.xls、目录、页眉页脚、透视表刷新等）。如果是非 Windows 系统，这些特定功能可能无法使用或受限。

服务器配置 (以 Cursor 为例)

您需要在 MCP 客户端（如 Cursor）中配置此服务器才能使用。以下是推荐的 JSON 配置方法：

  1. 在您的项目或工作区根目录创建 '.cursor' 文件夹（如果不存在）。

  2. 在该文件夹中创建 'mcp.json' 文件，填入以下内容：

    {
  "mcpServers": {
    "office-assistant": { // 服务器标识名，可以自定义，例如 "office-helper"
      "command": "python", // 运行服务器的命令，通常是 python
      "args": [
        // 这里填写您下载的服务器脚本的 **完整绝对路径**
        // 例如，如果您需要 Word 功能，填写 word_server.py 的路径
        // 如果需要 Excel 功能，填写 excel_server.py 的路径
        // 示例 (请务必替换为您的实际路径!):
         "C:/path/to/your/downloaded/office-editor-mcp/word_server.py"
        // 或者 "/Users/yourname/projects/office-editor-mcp/excel_server.py"
      ],
      "env": {
        // (可选) 设置环境变量，例如指定文件操作的基础路径
        // "OFFICE_EDIT_PATH": "C:/Users/YourUser/Documents/MCP_Output"
      }
    }
  }
}

    参数说明:

    • '"office-assistant"': 您为这个服务器起的名字，方便在客户端中识别。
    • '"command"': 启动服务器所使用的程序，通常是 'python'。
    • '"args"': 一个包含启动命令参数的列表。最关键的是第一个参数，即 服务器脚本的完整路径 ('word_server.py' 或 'excel_server.py')。请确保路径正确无误，使用 '/' 或 '\' (需要转义为 '\\') 作为路径分隔符。
    • '"env"': (可选) 环境变量设置。'OFFICE_EDIT_PATH' 可以指定服务器创建或读取文件的默认目录，不设置则默认为桌面。

  3. 重启 Cursor 使配置生效。

基本使用方法

  1. 确保 MCP 服务器已按照上述配置在客户端中启动。
  2. 在客户端的聊天或命令界面中，您可以尝试使用自然语言指令来调用服务器功能。例如：
    • "创建一个名为 '会议纪要.docx' 的 Word 文档"
    • "打开 '报告.docx' 并读取内容"
    • "在 '报告.docx' 的第 3 段后面添加文本 '这是补充内容'"
    • "将 '数据表.xlsx' 的 A1 单元格的值设为 100"
    • "读取 '数据表.xlsx' 工作表 'Sheet1' 中 A1 到 B5 单元格的数据"
    • "在 '预算.xlsx' 的 'Sheet1' 工作表 C 列应用 SUM 公式计算 C1 到 C10 的和，并将结果放在 C11"
  3. 服务器会执行相应的操作，并将结果或状态信息返回给客户端显示。文件默认会保存在您的桌面，或您通过 'OFFICE_EDIT_PATH' 环境变量指定的路径。

信息

分类

生产力应用

访问项目