Spire.Doc MCP 服务器是什么？

Spire.Doc MCP 服务器是一个模型上下文协议（MCP）服务器，它使您能够在不使用Microsoft Word的情况下操作Word文档。通过它，您可以直接使用您的AI代理来创建、读取和修改Word文档。

主要特性

• 从零开始创建Word文档
• 修改现有的Word文件
• 高保真地转换Word到PDF、Word到图片等
• 读取和写入文档内容
• 应用格式和样式
• 分析文档内容
• 表格操作和管理
• 段落操作和格式化
• 文档保护和安全
• 文档比较和合并
• 文本水印支持

快速入门

先决条件

• Python 3.10 或更高版本

安装

1. 克隆仓库：

git clone https://github.com/eiceblue/spire-doc-mcp-server.git
cd spire-doc-mcp-server

2. 使用uv安装：

uv pip install -e .

运行服务器

启动服务器（默认端口8000）：

uv run spire-doc-mcp-server

自定义端口（例如，8080）：

# Bash/Linux/macOS
export SPIRE_DOC_MCP_PORT=8080 && uv run spire-doc-mcp-server

# Windows PowerShell
$env:SPIRE_DOC_MCP_PORT = "8080"; uv run spire-doc-mcp-server

与AI工具集成

Cursor IDE

1. 在Cursor中添加此配置：

{
  "mcpServers": {
    "word": {
      "url": "http://localhost:8000/sse",
      "env": {
        "WORD_FILES_PATH": "/path/to/word/files"
      }
    }
  }
}

2. 您可以通过AI助手访问Word工具。

环境变量

变量	描述	默认值
WORD_FILES_PATH	Word文件目录	./word_files

可用工具

服务器提供18个工具，分为5类：

文档操作（6个工具）

• create_document: 创建新的Word文档，可选模板
• set_document_protection: 对文档应用密码保护
• find_and_replace: 在文档中搜索并替换文本
• merge_documents: 合并多个文档为一个
• add_text_watermark: 向文档添加文本水印

段落操作（5个工具）

• get_paragraph_text: 获取段落中的文本内容
• delete_paragraph: 从文档中删除段落
• get_paragraph_info: 获取详细的段落信息
• add_paragraph: 向文档中添加新段落
• update_paragraph_text: 修改段落文本内容

表格操作（6个工具）

• create_table: 创建具有指定尺寸的新表格
• add_table_after_paragraph: 在特定段落后插入表格
• add_table_to_section: 将表格添加到节的末尾
• get_table_info: 获取表格信息和结构
• delete_table: 从文档中删除表格
• set_cell_text: 设置单元格中的文本内容

格式化操作（2个工具）

• format_paragraph: 对段落应用格式（对齐方式、缩进、间距）
• get_paragraph_format: 获取段落格式信息

转换操作（3个工具）

• convert_document: 在不同格式之间转换文档
• get_conversion_status: 检查转换操作状态
• get_conversion_history: 查看转换历史

支持的格式

输入格式

• DOC: Microsoft Word 97-2003 文档
• DOCX: Microsoft Word 2007+ 文档
• DOCM: Microsoft Word 2007+ 宏启用文档
• DOT: Microsoft Word 97-2003 模板
• DOTX: Microsoft Word 2007+ 模板
• DOTM: Microsoft Word 2007+ 宏启用模板

输出格式

• DOC: Microsoft Word 97-2003 文档
• DOCX: Microsoft Word 2007+ 文档
• PDF: 可移植文档格式
• RTF: 富文本格式
• HTML: 超文本标记语言
• TXT: 纯文本
• EPUB: 电子出版物
• ODT: OpenDocument 文本
• XML: 可扩展标记语言
• Markdown: Markdown 格式

开发

项目结构

spire-doc-mcp-server/
├── src/spire_doc_mcp/
│   ├── api/                 # API 层（18个工具）
│   │   ├── document_tools.py
│   │   ├── paragraph_tools.py
│   │   ├── table_tools.py
│   │   ├── format_tools.py
│   │   └── conversion_tools.py
│   ├── core/               # 核心业务逻辑
│   │   ├── document.py
│   │   ├── paragraph.py
│   │   ├── table.py
│   │   ├── format.py
│   │   ├── conversion.py
│   │   └── base.py
│   ├── utils/              # 工具和常量
│   │   ├── exceptions.py
│   │   └── constants.py
│   ├── server.py           # MCP 服务器实现
│   └── __main__.py         # 入口点
├── pyproject.toml          # 项目配置
├── README.md              # 本文件
└── TOOLS.md               # 详细的工具文档

运行测试

uv run pytest

代码质量

该项目遵循Python最佳实践：

• 整体类型提示
• 全面的错误处理
• 一致的代码格式
• 详细的文档
• 模块化架构

文档

• TOOLS.md: 包含示例的全面工具文档
• API 参考: 详细的API文档
• 错误处理: 错误代码和故障排除

🤝 贡献

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 如适用，添加测试
5. 提交拉取请求

许可证

本项目采用MIT许可证 - 详情见LICENSE文件。

支持

对于支持和问题：

• 查看TOOLS.md文档
• 查阅错误处理部分
• 在GitHub上打开一个问题

版本历史

• v1.0.0: 初始稳定版，包含18个工具
• 完整的Word文档操作能力
• 全面的错误处理
• 完整的格式转换支持