Document Edit MCP

🚀 Claude 文檔 MCP 服務器

Claude 文檔 MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它允許 Claude Desktop 對 Microsoft Word、Excel 和 PDF 文件執行各種文檔操作，極大地提升了文檔處理的效率和便捷性。

🚀 快速開始

此 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

📚 詳細文檔

Model Context Protocol 集成

此服務器遵循 Model Context Protocol 規範，以提供文檔操作功能供 Claude Desktop 使用：

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

💻 使用示例

基礎用法

以下是使用 API 進行文檔操作的示例：

創建 Word 文檔

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

編輯 Word 文檔

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

將 TXT 轉換為 Word

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

創建 Excel 文件

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

編輯 Excel 文件

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

將 CSV 轉換為 Excel

# 將 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

# 將 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。