Spire是什么。Doc MCP服务器?
Spire。Doc MCP Server是一个模型上下文协议(MCP)服务器,使您能够在不需要Microsoft Word的情况下操纵Word文档。有了它,你可以 创建, 读,以及 修改 Word文档直接使用您的AI代理。
主要特点
- 从头开始创建Word文档
- 修改现有Word文件
- 转换 Word转PDF, 文字到图像,以及更高的保真度
- 阅读 和 写入文档内容
- 应用格式和样式
- 分析文档内容
- 表操作和管理
- 段落操作和格式
- 文件保护和安全
- 文件比较 和 合并
- 文字水印 支持
快速开始
先决条件
- Python 3.10或更高版本
安装
- 克隆存储库:```bash
git clone https://github.com/eiceblue/spire-doc-mcp-server.git
cd spire-doc-mcp-server
2. 使用紫外线进行安装:```bash
uv pip install -e .
运行服务器
启动服务器(默认端口8000):```bash
uv run spire-doc-mcp-server
自定义端口(例如8080):```bash
# 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
- 将此配置添加到游标:```json
{
"mcpServers": {
"word": {
"url": "http://localhost:8000/sse",
"env": {
"WORD_FILES_PATH": "/path/to/word/files"
}
}
}
}
2. 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
运行测试```bash
uv run pytest
```
代码质量
该项目遵循Python最佳实践:
- 全程键入提示
- 全面的错误处理
- 一致的代码格式
- 详细文件
- 模块化架构
文档
- TOOLS.md:包含示例的综合工具文档
- api参考:API详细文件
- 错误处理:错误代码和故障排除
🤝 贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用,添加测试
- 提交拉取请求
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
支持
有关支持和问题:
- 检查 TOOLS.md 文档
- 查看错误处理部分
- 在GitHub上打开一个问题
版本历史记录
- v1.0.0:带有18个工具的初始稳定版本
- 完整的Word文档操作功能
- 全面的错误处理
- 完全格式转换支持
