使用说明
Docx MCP服务器📄
模型上下文协议(MCP)服务器,使AI代理能够读取、编辑和创建Microsoft Word文档(.docx).它支持富文本、表格和图像,并提供灵活的部署选项(独立可执行文件、Python/UVX、SSE/Remote)。
✨ 特性
- 文档管理:创建新文档或加载现有文档。
- 内容读取:阅读文档结构、段落、表格和 图像.
- 丰富的编辑:
- 添加风格化的段落(粗体,斜体通过样式处理)。
- 添加标题(级别1-9)。
- 插入图片 (从本地路径或Base64)。
- 创建表格 使用自定义数据。
- 图像提取:将docx文件中的图像提取到本地磁盘。
- 多模式支持:
- StdIO:本地MCP客户端的标准集成(例如Claude Desktop)。
- 上海证券交易所:服务器发送事件支持远程或基于URL的连接。
🚀 快速开始
选项1:独立资源管理器(不需要Python)
下载最新版本并直接运行可执行文件。
- 获取
docx-mcp-server.exe从 发布 页面。 - 在终端中运行或在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 |
保存更改(覆盖或新建路径)。 |
🏗️ 发展
- 克隆:
git clone https://github.com/OkamiFeng/docx-mcp-server.git - 安装:
uv sync或pip install -r requirements.txt - 构建Exe:
pyinstaller --name docx-mcp-server --onefile server.py --icon="icon.png" --collect-all docx
📄 许可证
麻省理工学院
