MCP Docx

MCP文档知识

提供方 AndersonTaborga

文档知识 stdio · 本地进程 无需鉴权 社区 / 第三方 ClaudeCursor
查看接入方式

MCP (Model Context Protocol)服务器,用于生成、编辑和操作Word文档(.docx),支持从模板创建、邮件合并、格式转换等功能。

一句话选型结论

按资料字段整理

MCP Docx 属于文档知识类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude、Cursor,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 12 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量12暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

文档生成Python本地部署邮件合并格式转换文档编辑自动化处理

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install -e .

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 12 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 12 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Docx当前 12 stdio · 本地进程 本地部署 有 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方AndersonTaborga上游标注的维护方 AndersonTaborga
分类文档知识本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.1 KB
来自项目仓库与上游目录的原文,未做删改

mcp-docx

用于Word文档的MCP(模型上下文协议)服务器:生成、编辑和操作 .docx 来自Cursor、Claude或任何MCP客户端的文件。用Python实现。

特性

  • 生成 模板中的文档(Jinja2占位符 {{ name }}, {{ date }})或从头开始创建新文档; 邮件合并 对于Word合并字段(«Nome», «Data»)
  • 编辑 现有文档:替换占位符,插入段落
  • 操纵 文档:合并多个文件,提取纯文本,获取元数据(段落数、字数)
  • 格式 具有标题、标题、项目符号列表和 图像 (可选额外)
  • 转换 通过Pandoc将PDF转换为.docx、.docx转换为HTML以及其他格式(可选附加)

需求

  • Python 3.10+
  • pip或uv

安装```bash

git clone https://github.com/AndersonTaborga/mcp-docx.git
cd mcp-docx
pip install -e .


或者使用紫外线:```bash
uv pip install -e .

光标配置

在中添加MCP服务器 光标设置→ MCP 或者直接编辑配置文件:

  • 窗户: %USERPROFILE%\.cursor\mcp.json
  • macOS/Linux: ~/.cursor/mcp.json

示例(从项目根目录运行;使用您的实际项目路径 cwd):```json
{
"mcpServers": {
"mcp-docx": {
"command": "python",
"args": ["-m", "mcp_docx.server"],
"cwd": "C:/path/to/mcp-docx-python"
}
}
}


你 **必须** 集 `cwd` 到项目根(其中 `pyproject.toml` 和 `src/` 生活)所以 `mcp_docx` 可以加载模块。

或者,在 `pip install -e .`,您可以使用已安装的脚本(仍设置 `cwd` 如果需要,可以加入该项目):```json
{
"mcpServers": {
"mcp-docx": {
"command": "mcp-docx",
"cwd": "C:/path/to/mcp-docx-python"
}
}
}

如果光标未找到 python 在PATH中,使用Python可执行文件的完整路径(例如。 C:/Users/You/AppData/Local/Programs/Python/Python310/python.exe 在Windows上)。

工具

所有工具都接受路径 .docx (或其他注明的格式)在服务器进程可访问的文件系统上。

工具 说明
create_document 从头开始创建一个新的.docx,带有标题和段落列表。
create_document_formatted 创建一个格式良好的.docx,包括标题、副标题、标题(1-2级)、段落、项目符号列表和可选图像(image 阻断;需要 [images]).
generate_from_template 从模板和JSON对象生成.docx。模板使用Jinja2: {{ name }}, {{ date }}.
mail_merge 在.docx模板中填写Word邮件合并字段(例如。 «Nome», «Data»).需要 [mailmerge].
replace_text 替换现有.docx(Jinja2)中的占位符并保存到新文件中。
insert_paragraph 在现有.docx的末尾插入一段并保存到新文件。
merge_documents 将多个.docx文件合并为一个(使用第一个文件的样式)。
extract_text 从.docx文件中提取纯文本。
get_document_info 获取基本元数据:段落数、字数和简短文本预览。
convert_pdf_to_docx 将PDF文件转换为.docx。需要 [pdf].
docx_to_html 将.docx文件转换为HTML。退货 html 和 messages。需要 [html].
convert_document 使用Pandoc将文档转换为另一种格式(例如docx、html、md)。需要 [pandoc] 以及PATH上的Pandoc。

可选功能

某些工具需要可选的依赖关系。使用以下方式安装它们:```bash
pip install mcp-docx[pdf,html,images,mailmerge]

or install everything including Pandoc support:

pip install mcp-docx[all]


|额外|已安装Libs |已启用工具|
|-------|----------------|----------------|
| `images` |枕头| `image` 把…的车堵住 `create_document_formatted` |
| `pdf` |pdf2docx| `convert_pdf_to_docx` |
| `html` |猛犸象| `docx_to_html` |
| `mailmerge` |docx邮件合并| `mail_merge` |
| `pandoc` |潘多克| `convert_document` (Pandoc二进制文件必须在PATH上)|

如果没有相应的额外信息,该工具会返回一条错误消息,指示您安装它(例如。 `pip install mcp-docx[pdf]`).

### 示例:generate_from_template

- **模板路径**:通往a的道路 `.docx` 模板,例如。 `Hello {{ name }}, date: {{ date }}`.
- **outputPath**:将生成的文件写入何处。
- **数据**: `{ "name": "World", "date": "2025-01-01" }`.

### 示例:create_document

- **outputPath**:输出文件的路径。
- **标题**:文档标题。
- **段落**:字符串数组,例如。 `["First paragraph.", "Second paragraph."]`.

### 示例:create_document_formated

- **outputPath**:输出文件的路径。
- **内容块**:对象数组。每个对象都有 **类型** 以及:
- `{"type": "heading", "level": 1 or 2, "text": "Section title"}`
- `{"type": "paragraph", "text": "Body text."}`
- `{"type": "list_bullet", "items": ["Item one.", "Item two."]}`
- `{"type": "image", "path": "/path/to/image.png", "width_inches": 2.0}` (要求 `[images]`)
- **标题** (可选):居中的文档标题。
- **字幕** (可选):居中字幕。
- **font_name** (可选):默认字体,例如。 `"Calibri"`.
- **font_size_pt** (可选):默认字体大小,例如。 `11`.

### 示例:mail_merge

- **模板路径**:带有Word合并字段的.docx路径(例如。 `«Nome»`, `«Data»`).
- **outputPath**:填写文件的位置。
- **合并数据**: `{ "Nome": "João", "Data": "2025-01-15" }`.退货 `{ "outputPath": "...", "message": "..." }`.

### 示例:convert_pdf_to_docx

- **pdf_path**:PDF文件的路径。
- **输出路径**:输出.docx的路径。退货 `{ "outputPath": "...", "message": "..." }`.

### 示例:docx_to_html

- **文档路径**:.docx文件的路径。退货 `{ "html": "

...
", "messages": [] }`.

### 示例:convert_document

- **输入路径**:源文件的路径。
- **输出路径**:输出文件的路径。
- **输出格式**:例如。 `"docx"`, `"html"`, `"md"`.退货 `{ "outputPath": "...", "message": "..." }`.

### 示例:extract_text

- **documentPath**:通往 `.docx` 文件。退货 `{ "text": "..." }`.

## 架构和工作流程

### 堆栈(架构)```mermaid
flowchart TB
Client[Cursor / IDE]
MCP[mcp-docx Server]
Gen[tools_generate]
Edit[tools_edit]
Manip[tools_manipulate]
Conv[tools_convert]
Lib[lib/docx_utils]
Docx[python-docx]
Docxtpl[docxtpl]
Pdf[pdf2docx]
Mammoth[mammoth]
MailMerge[docx-mailmerge]
Pandoc[pypandoc]
Pillow[Pillow]
Client --> MCP
MCP --> Gen
MCP --> Edit
MCP --> Manip
MCP --> Conv
Gen --> Lib
Gen --> Docxtpl
Edit --> Docxtpl
Manip --> Lib
Conv --> Pdf
Conv --> Mammoth
Conv --> Pandoc
Gen --> MailMerge
Lib --> Docx
Gen --> Pillow

工具类别```mermaid

flowchart LR
subgraph Generate
create_document
create_document_formatted
generate_from_template
mail_merge
end
subgraph Edit
replace_text
insert_paragraph
end
subgraph Manipulate
merge_documents
extract_text
get_document_info
end
subgraph Convert
convert_pdf_to_docx
docx_to_html
convert_document
end


### 流程:生成vs转换```mermaid
flowchart TD
A[Need a document] --> B{How?}
B -->|From scratch| C[create_document / create_document_formatted]
B -->|Jinja2 template| D[generate_from_template]
B -->|Word merge fields| E[mail_merge]
B -->|PDF source| F[convert_pdf_to_docx]
B -->|docx to web| G[docx_to_html]
B -->|Other formats| H[convert_document - Pandoc]

兼容性

输出是标准的Office Open XML(OOXML),与Microsoft Word和其他支持 .docx。模板最好在Word中创建和格式化,以获得最佳保真度。

文本编码

所有文本输入都应 Unicode(UTF-8)。服务器在写入之前将文本标准化为Unicode NFC,以便正确存储葡萄牙语和其他重音字符。

代理技能

此存储库包括 代理技能 (SKILL.md)in .cursor/技能/ 以便Cursor的代理使用mcp-docx-mcp,具有更好的格式、生成和流畅性。当您在Cursor中打开此项目时,代理可以自动加载这些技能(从 .cursor/skills/ 或 .agents/skills/).

技能 描述
mcp-docx快速参考 单页参考:工具名称、参数和content_blocks格式。
mcp-docx格式 使用带有标题、段落和项目符号列表的create_document_formated进行专业布局。
mcp-docx简单vs格式化 何时使用create_document与create_document_formatted。
mcp-docx流利度 将自然语言请求映射到正确的mcp-docx工具和参数。
mcp-docx文档结构 现成的结构:会议纪要、报告、演示文稿、清单。
mcp-docx模板 使用generate_from_template和replace_text进行基于模板的生成。
mcp-docx合并提取 使用合并文档、提取文本和获取文档信息。
mcp-docx编码 UTF-8和NFC标准化;避免在生成的文档中使用mojibake。

技能遵循 代理技能 格式。它们不会改变MCP服务器;他们指导代理何时以及如何调用工具。

贡献

看 贡献.md.开发已完成 dev 分支; main 用于生产发布。

测试MCP

在Cursor中安装和配置服务器后,您可以要求AI使用 创建_文档 工具(或任何其他工具)生成 .docx 在您选择的文件夹中。例子: “通过MCP创建一个标题为X和两段的测试文档。” AI将调用MCP,文件将写入您或AI指定的路径。

许可证

麻省理工学院

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
MCP Docx 怎么安装?

在客户端按下面的安装命令接入:pip install -e .。装完在客户端配置里引用同一个包或端点。

MCP Docx 怎么在 Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Docx 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Docx 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Docx 支持哪些客户端?

资料标注支持 Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Docx 能提供哪些能力?

资料显示约 12 个工具;能力标签包括 文档生成、格式转换、Python、Claude。具体工具清单以官方文档为准。

MCP Docx 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

MCP Docx 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。