Spire是什么。Doc MCP服务器？
Spire。Doc MCP Server是一个模型上下文协议（MCP）服务器，使您能够在不需要Microsoft Word的情况下操纵Word文档。有了它，你可以 创建, 读，以及 修改 Word文档直接使用您的AI代理。
主要特点
- 从头开始创建Word文档
- 修改现有Word文件
- 阅读 和 写入文档内容
- 应用格式和样式
- 分析文档内容
- 表操作和管理
- 段落操作和格式
- 文件保护和安全
- 文字水印 支持
快速开始
先决条件
- Python 3.10或更高版本
安装
- 克隆存储库：
git clone https://github.com/eiceblue/spire-doc-mcp-server.git
cd spire-doc-mcp-server- 使用紫外线进行安装：
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工具集成
光标IDE
- 将此配置添加到游标：
{
"mcpServers": {
"word": {
"url": "http://localhost:8000/sse",
"env": {
"WORD_FILES_PATH": "/path/to/word/files"
}
}
}
}- Word工具将通过您的AI助手提供。
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
WORD_FILES_PATH | Word文件目录 | ./word_files |
可用工具
服务器提供 18工具 分为5类：
文档操作（6个工具）
- 创建_文档：使用可选模板创建新的Word文档
- set_document_保护：对文档应用密码保护
- 查找和替换：搜索和替换文档中的文本
- 合并文档：将多个文档合并为一个
- 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_cection：在章节末尾添加表格
- get_table_info：获取表信息和结构
- delete_table：从文档中删除表
- set_cell_text：设置表格单元格中的文本内容
格式化操作（2个工具）
- 格式图：对段落应用格式（对齐、缩进、间距）
- get_paragraph_format：检索段落格式信息
转换操作（3个工具）
- convert_文档：在不同格式之间转换文档
- get_version_status：检查转换操作状态
- get_version_history：查看转换历史记录
支持格式
输入格式
- 文档：微软Word 97-2003文档
- 文档：Microsoft Word 2007+文档
- DOCM：Microsoft Word 2007+启用宏的文档
- 点：Microsoft Word 97-2003模板
- DOTX：Microsoft Word 2007+模板
- DOTM：Microsoft Word 2007+启用宏的模板
输出格式
- 文档：微软Word 97-2003文档
- 文档：Microsoft Word 2007+文档
- 可移植文档格式：可移植文档格式
- RTF格式：RTF格式
- 超文本标记语言：超文本标记语言
- 文本：纯文本
- 电子版：电子出版物
- 海洋数据发射机：OpenDocument文本
- 可扩展置标语言：可扩展标记语言
- 降价：Markdown格式
发展
项目结构
spire-doc-mcp-server/
├── src/spire_doc_mcp/
│ ├── api/ # API layer (18 tools)
│ │ ├── document_tools.py
│ │ ├── paragraph_tools.py
│ │ ├── table_tools.py
│ │ ├── format_tools.py
│ │ └── conversion_tools.py
│ ├── core/ # Core business logic
│ │ ├── document.py
│ │ ├── paragraph.py
│ │ ├── table.py
│ │ ├── format.py
│ │ ├── conversion.py
│ │ └── base.py
│ ├── utils/ # Utilities and constants
│ │ ├── exceptions.py
│ │ └── constants.py
│ ├── server.py # MCP server implementation
│ └── __main__.py # Entry point
├── pyproject.toml # Project configuration
├── README.md # This file
└── TOOLS.md # Detailed tool documentation运行测试
uv run pytest代码质量
该项目遵循Python最佳实践：
- 全程键入提示
- 全面的错误处理
- 一致的代码格式
- 详细文件
- 模块化架构
文档
🤝 贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用，添加测试
- 提交拉取请求
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
支持
有关支持和问题：
- 检查 TOOLS.md 文档
- 查看错误处理部分
- 在GitHub上打开一个问题
版本历史记录
- v1.0.0：带有18个工具的初始稳定版本
- 完整的Word文档操作功能
- 全面的错误处理
- 完全格式转换支持