Document Operations (Word, Excel, PDF)

🚀 用於Claude Desktop的文檔編輯MCP服務器

這是一個基於模型上下文協議（MCP）的服務器，它允許Claude Desktop在Microsoft Word、Excel和PDF文件上執行各類文檔操作，極大地拓展了Claude Desktop的文檔處理能力。

🚀 快速開始

該MCP服務器要求使用Python 3.10或更高版本。下面為你提供詳細的安裝步驟。

✨ 主要特性

Microsoft Word 操作

• 可使用文本創建新的Word文檔。
• 支持編輯現有Word文檔，包括添加、修改或刪除段落和標題。
• 能夠將文本文件（.txt）轉換為Word文檔。

Excel 操作

• 可從JSON或CSV格式的文本創建新的Excel電子表格。
• 支持編輯現有的Excel文件，如更新單元格、範圍，添加或刪除行、列、工作表。
• 能夠將CSV文件轉換為Excel。

PDF 操作

• 可使用文本創建新的PDF文件。
• 能夠將Word文檔轉換為PDF文件。

📦 安裝指南

自動安裝（推薦）

運行設置腳本來自動安裝依賴項並配置Claude Desktop：

git clone https://github.com/alejandroBallesterosC/document-edit-mcp
cd document-edit-mcp
./setup.sh

此操作將完成以下步驟：

1. 創建虛擬環境。
2. 安裝所需的依賴項。
3. 配置服務器以供Claude Desktop使用。
4. 創建必要的目錄。

手動安裝（如果需要）

如果你更喜歡手動安裝，可按以下步驟操作：

1. 安裝依賴項：

cd claude-document-mcp
python -m venv .venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate
pip install -e .

2. 配置Claude Desktop： 複製claude_desktop_config.json文件到：

• Mac：~/Library/Application Support/Claude/
• Windows：%APPDATA%\Claude\

3. 重啟Claude Desktop。

📚 詳細文檔

模型上下文協議集成

該服務器遵循模型上下文協議規範，以向Claude Desktop提供文檔處理功能：

• 工具：提供了對Word、Excel和PDF操作的操縱函數。
• 資源：提供了有關功能的信息。
• 提示：（目前尚未實現）

💻 使用示例

基礎用法

以下是使用該服務器API的一些基礎示例：

Microsoft Word

# 創建Word文檔
create_word_document(filepath: str, content: str) -> Dict

# 編輯Word文檔
edit_word_document(filepath: str, operations: List[Dict]) -> Dict

# 將TXT轉換為Word
convert_txt_to_word(source_path: str, target_path: str) -> Dict

Excel

# 創建Excel文件
create_excel_file(filepath: str, content: str) -> Dict

# 編輯Excel文件
edit_excel_file(filepath: str, operations: List[Dict]) -> Dict

# 將CSV轉換為Excel
convert_csv_to_excel(source_path: str, target_path: str) -> Dict

PDF

# 創建PDF文件
create_pdf_file(filepath: str, content: str) -> Dict

# 將Word轉換為PDF
convert_word_to_pdf(source_path: str, target_path: str) -> Dict

📄 API文檔

Microsoft Word

創建Word文檔

create_word_document(filepath: str, content: str) -> Dict

編輯Word文檔

edit_word_document(filepath: str, operations: List[Dict]) -> Dict

將TXT轉換為Word

convert_txt_to_word(source_path: str, target_path: str) -> Dict

Excel

創建Excel文件

create_excel_file(filepath: str, content: str) -> Dict

編輯Excel文件

edit_excel_file(filepath: str, operations: List[Dict]) -> Dict

將CSV轉換為Excel

convert_csv_to_excel(source_path: str, target_path: str) -> Dict

PDF

創建PDF文件

create_pdf_file(filepath: str, content: str) -> Dict

將Word轉換為PDF

convert_word_to_pdf(source_path: str, target_path: str) -> Dict

🔧 技術細節

服務器將所有操作同時記錄到控制檯和logs/document_mcp.log文件中，以便於故障排除。

📄 許可證

本項目採用MIT許可證。

🤝 貢獻

歡迎任何貢獻！請隨時提交Pull Request。