Docx文档处理服务

一个基于Model Context Protocol (MCP)的服务,支持AI代理读取、编辑和创建Microsoft Word文档(.docx),包括富文本、表格和图片处理,提供多种部署选项。

  • by OkamiFeng
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 OkamiFeng/docx-mcp-server

使用说明

Docx MCP服务器📄

模型上下文协议(MCP)服务器,使AI代理能够读取、编辑和创建Microsoft Word文档(.docx).它支持富文本、表格和图像,并提供灵活的部署选项(独立可执行文件、Python/UVX、SSE/Remote)。

✨ 特性

  • 文档管理:创建新文档或加载现有文档。
  • 内容读取:阅读文档结构、段落、表格和 图像.
  • 丰富的编辑:
    • 添加风格化的段落(粗体,斜体通过样式处理)。
    • 添加标题(级别1-9)。
    • 插入图片 (从本地路径或Base64)。
    • 创建表格 使用自定义数据。
  • 图像提取:将docx文件中的图像提取到本地磁盘。
  • 多模式支持:
    • StdIO:本地MCP客户端的标准集成(例如Claude Desktop)。
    • 上海证券交易所:服务器发送事件支持远程或基于URL的连接。

🚀 快速开始

选项1:独立资源管理器(不需要Python)

下载最新版本并直接运行可执行文件。

  1. 获取 docx-mcp-server.exe 从 发布 页面。
  2. 在终端中运行或在MCP客户端中配置。

选项2:使用UVX(需要PyPI发布)

⚠️ 备注:这个包裹是 不 目前由作者发布到PyPI。 使用 uvx,您必须自己分叉并发布它,或者在本地安装。

如果发布到PyPI,您可以运行:

uvx docx-mcp-server

方案3:发展/当地来源

# Clone the repository
git clone https://github.com/OkamiFeng/docx-mcp-server.git
cd docx-mcp-server

# Run with uv
uv run docx-mcp-server

🛠️ 配置

克劳德桌面版

使用UVX(如果发布到PyPI)

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

Windows(使用.exe)

{
  "mcpServers": {
    "docx": {
      "command": "C:/Path/To/docx-mcp-server.exe",
      "args": []
    }
  }
}

Windows(使用Python/UV)

{
  "mcpServers": {
    "docx": {
      "command": "uv",
      "args": ["run", "--directory", "C:/Projects/docx-mcp-server", "docx-mcp-server"]
    }
  }
}

远程/SSE配置

要在HTTP模式下运行服务器(可通过URL访问):

# Using Exe
docx-mcp-server.exe --transport sse --port 8000

# Using Python
uv run server.py --transport sse --port 8000

SSE端点: http://localhost:8000/sse


📚 可用工具

工具名称 描述
create_new_document 创建一个新的空文档。
load_document 加载现有 .docx 文件从路径。
get_document_structure 获得段落和内容计数的简化JSON视图。
add_paragraph 添加具有可选样式的文本段落。
add_heading 添加标题(级别1-9)。
add_table 插入一个包含指定行、列和数据的表。
add_image 从文件路径或Base64字符串中插入图像
extract_images 将加载文档中的所有图像提取到文件夹中。
save_document 保存更改(覆盖或新建路径)。

🏗️ 发展

  1. 克隆: git clone https://github.com/OkamiFeng/docx-mcp-server.git
  2. 安装: uv sync 或 pip install -r requirements.txt
  3. 构建Exe:
    pyinstaller --name docx-mcp-server --onefile server.py --icon="icon.png" --collect-all docx
    

📄 许可证

麻省理工学院