Office Word

🚀 辦公室 Word-MCP 服務器

辦公室 Word-MCP 服務器實現了模型上下文協議（MCP），可用於創建、讀取和操作 Microsoft Word 文檔。與 Claude for Desktop 或其他 MCP 客戶端配合使用時，能對文檔進行自動化處理，提升辦公效率。

🚀 快速開始

辦公室 Word-MCP 服務器是一個基於 Model Context Protocol (MCP) 的工具，可用於對 Word 文檔進行自動化處理。使用前，請確保滿足系統要求並完成安裝步驟。

✨ 主要特性

• 文檔管理：支持創建、讀取、保存和關閉 Word 文檔，方便對文檔的全生命週期進行管理。
• 內容創建：可添加標題、段落、表格、圖片和分頁符，滿足多樣化的文檔內容需求。
• 文本格式化：能夠調整文本樣式，如加粗、斜體、顏色等，還可查找並替換文本、刪除段落。
• 表格格式化：可以設置表格邊框、背景和其他屬性，使表格更加美觀。

📦 安裝指南

系統要求

• 操作系統：Windows、Linux 或 macOS。
• Python 版本：3.6+。

安裝步驟

1. 克隆項目倉庫：

git clone https://github.com/your-repository.git

2. 安裝依賴項：

pip install python-docx fastmcp

💻 使用示例

基礎用法

# 添加標題
add_heading("example.docx", "這是一個標題", level=1)

# 添加段落
add_paragraph("example.docx", "這是第一段文字。")

# 添加表格
add_table("example.docx", 2, 2)

# 調整文本樣式
format_text("example.docx", 0, 0, 5, bold=True, color="FF0000")

高級用法

# 配置 Claude for Desktop
# 打開 settings.json 文件，添加以下配置
# 啟動服務器並連接到 Claude
{
    "mcp_server": "file:///path/to/server.py"
}

📚 詳細文檔

功能詳情

文檔管理

• create_document：創建新文檔。
• open_document：打開現有文檔。
• save_document：保存文檔。
• close_document：關閉文檔。

內容創建

• add_heading：添加標題。
• add_paragraph：添加段落。
• add_table：添加表格。
• add_picture：插入圖片。
• add_page_break：插入分頁符。

文本格式化

• format_text：調整文本樣式（如加粗、斜體、顏色等）。
• search_and_replace：查找並替換文本。
• delete_paragraph：刪除段落。

表格格式化

• format_table：設置表格邊框、背景和其他屬性。

API 文檔

文檔管理接口

• create_document(path: str) -> None：創建新文檔，指定文件路徑。
• open_document(path: str) -> None：打開現有文檔。
• save_document() -> None：保存當前文檔。

內容創建接口

• add_heading(text: str, level: int = 1) -> None：添加標題，指定文字和標題級別。

🔧 技術細節

本服務器基於 Model Context Protocol (MCP) 實現，與 Claude for Desktop 或其他 MCP 客戶端配合使用，實現對 Word 文檔的自動化處理。在處理文檔時，會遇到樣式缺失和權限問題，服務器會嘗試創建缺失的樣式或直接應用格式化，並提示用戶確保對文件路徑具有讀寫權限。

📄 許可證

本項目使用 MIT License，具體內容見 LICENSE 文件。

⚠️ 重要提示

此服務器與文檔文件交互，請確保操作適當後再在 Claude for Desktop 等 MCP 客戶端中確認。

💡 使用建議

若遇到樣式缺失問題，服務器會嘗試創建缺失的樣式或直接應用格式化；若遇到權限問題，可使用 copy_document 創建可編輯副本。