mcpField
M
MCP Server Office

MCP Server Office

本地服务
github.com/famano生产力4078 周前更新

关于 MCP Server Office

MCP Server Office 是一个用于读写 Microsoft Word(docx)文件的 MCP 服务,可通过 pip 或 uvx 安装。适合需要让 AI 助手读取、生成或修改 Word 文档的用户。

主要功能

  1. 01读取 docx 内容,包括表格与图片占位
  2. 02创建带段落与表格的新 docx 文件
  3. 03替换指定段落中的文本
  4. 04在指定位置插入新段落

适用场景

  1. 01让 AI 助手读取 Word 文档内容并进行摘要
  2. 02批量生成或修改 Word 文档中的段落
  3. 03在已有文档中插入新的章节或说明

MCP 相关

该项目是 MCP 服务,向 MCP 客户端暴露 read_docx、write_docx、edit_docx_paragraph 与 edit_docx_insert 等工具。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"office": {
"command": "uvx",
"args": [
"mcp-server-office"
]
}
}
}
启动命令uvx mcp-server-office

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypimcp-server-office

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

MCP Server Office

smithery badge

一个 Model Context Protocol(MCP)服务,提供读写 Microsoft Word(docx)文件的工具。

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Server Office:

npx -y @smithery/cli install @famano/mcp-server-office --client claude

使用方法

使用 pip 安装:

pip install mcp-server-office

然后启动 MCP 服务:

mcp-server-office

或者使用 uv,只需运行:

uvx mcp-server-office
可用工具
  1. read_docx:读取 docx 文件的完整内容,包括表格和图片。

    • 输入:path(字符串)- 目标文件的绝对路径
    • 注意:图片会转换为 [图片] 占位符,且不会显示修订内容
  2. write_docx:根据指定内容创建新的 docx 文件。

    • 输入:
      • path(字符串)- 目标文件的绝对路径
      • content(字符串)- 要写入文件的内容
    • 注意:新段落之间使用两个换行符,表格使用 [表格] 标签和 | 分隔符
  3. edit_docx_paragraph:替换 docx 文件指定段落中的文本。

    • 输入:
      • path(字符串)- 要编辑的文件的绝对路径
      • edits(数组)- 包含搜索/替换文本和段落索引的字典列表
        • paragraph_index(数字)- 要编辑段落的从 0 开始的索引
        • search(字符串)- 要在指定段落中查找的文本
        • replace(字符串)- 要替换为的文本
    • 注意:每个搜索字符串在指定段落中必须恰好匹配一次
  4. edit_docx_insert:在 docx 文件中插入新段落。

    • 输入:
      • path(字符串)- 要编辑的文件的绝对路径
      • inserts(数组)- 包含文本和可选段落索引的字典列表
        • text(字符串)- 要作为新段落插入的文本
        • paragraph_index(数字,可选)- 要在其前面插入的段落的从 0 开始的索引。若未指定,则插入到末尾。

要求

  • Python >= 3.12
  • 依赖项:
    • mcp[cli] >= 1.2.0
    • python-docx >= 1.1.2

MCP Server Office(中文)

smithery badge

一个提供 Microsoft Word(docx)文件读写工具的 Model Context Protocol(MCP)服务。

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Server Office:

npx -y @smithery/cli install @famano/mcp-server-office --client claude

使用方法

使用 pip 安装:

pip install mcp-server-office

启动 MCP 服务:

mcp-server-office

或者使用 uv:

uvx mcp-server-office
可用工具
  1. read_docx:读取 docx 文件的完整内容,包括表格和图片。

    • 输入:path(字符串)- 目标文件的绝对路径
    • 注意:图片会转换为 [图片] 占位符,且不会显示修订内容
  2. write_docx:根据指定内容创建新的 docx 文件。

    • 输入:
      • path(字符串)- 要创建文件的绝对路径
      • content(字符串)- 要写入文件的内容
    • 注意:段落之间使用两个换行符,表格使用 [表格] 标签和 | 分隔符
  3. edit_docx_paragraph:替换 docx 文件指定段落中的文本。

    • 输入:
      • path(字符串)- 要编辑的文件的绝对路径
      • edits(数组)- 包含搜索/替换文本和段落索引的字典列表
        • paragraph_index(数字)- 要编辑段落的从 0 开始的索引
        • search(字符串)- 要在指定段落中查找的文本
        • replace(字符串)- 要替换为的文本
    • 注意:每个搜索字符串在指定段落中必须恰好匹配一次
  4. edit_docx_insert:在 docx 文件中插入新段落。

    • 输入:
      • path(字符串)- 要编辑的文件的绝对路径
      • inserts(数组)- 包含文本和可选段落索引的字典列表
        • text(字符串)- 要作为新段落插入的文本
        • paragraph_index(数字,可选)- 要在其前面插入的段落的从 0 开始的索引。若未指定,则插入到末尾。

要求

  • Python >= 3.12
  • 依赖项:
    • mcp[cli] >= 1.2.0
    • python-docx >= 1.1.2

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。