Office Word MCP Server

🚀 辦公室 Word MCP 服務器

這是一個基於模型上下文協議（MCP）的服務器，可用於創建、讀取和操作微軟 Word 文檔。它為 AI 助手提供了標準化接口，使其能與 Word 文檔交互，具備豐富的文檔編輯功能。

🚀 快速開始

此服務器基於模型上下文協議（MCP），用於與微軟 Word 文檔交互。它支持文檔操作，如添加標題、段落、表格和圖片，以及文本和表格格式化。

✨ 主要特性

• 文檔操作：創建、讀取和修改 Word 文檔。
• 內容添加：支持添加標題、段落、表格和圖片。
• 文本格式化：包括加粗、斜體、下劃線、顏色和字體大小等。
• 表格格式化：支持表頭行、邊框樣式和單元格底紋設置。

📦 安裝指南

環境要求

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

安裝步驟

1. 克隆倉庫：

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

2. 安裝依賴項：

   pip install python-docx fastmcp
   

3. 啟動服務器：

   export MCP_SERVER=office-word-mcp-server  # Linux/macOS
   set MCP_SERVER=office-word-mcp-server     # Windows
   python server.py
   

💻 使用示例

文檔路徑設置

1. 配置文檔存儲路徑：
   • 修改 config.json 文件，指定 document_storage_path。

   {
     "document_storage_path": "/path/to/storage"
   }
   

2. 上傳模板：
   • 將 Word 模板文件放入 templates 目錄。

基礎用法

添加標題

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

添加段落

add_paragraph("example.docx", "這是一個段落。")

添加表格

add_table("example.docx", rows=2, cols=3)

📚 詳細文檔

API 參考

文檔操作

• 創建新文檔：

  create_document(filename)
  

• 打開現有文檔：

  open_document(filename)
  

內容添加

• 添加標題：

  add_heading(filename, text, level=1)
  

• 添加段落：

  add_paragraph(filename, text, style=None)
  

文本格式化

• 設置文本樣式：

  format_text(filename, paragraph_index, start_pos, end_pos, bold=None,
              italic=None, underline=None, color=None, font_size=None, font_name=None)
  

故障排除

常見問題

1. 缺少樣式
   • 使用 Word 模板以確保所有必要樣式可用。
2. 權限問題
   • 確保服務器有讀寫文檔的權限。
3. 圖片插入失敗
   • 使用絕對路徑並檢查圖片格式和大小。

調試

啟用詳細日誌：

export MCP_DEBUG=1  # Linux/macOS
set MCP_DEBUG=1     # Windows

🤝 貢獻指南

歡迎貢獻！請參考以下步驟：

1. Fork 倉庫。
2. 創建功能分支。
3. 提交更改。
4. 推送到遠程倉庫。
5. 提交 Pull Request。

📄 許可證

本項目使用 MIT License。具體信息見 LICENSE 文件。

🙏 致謝

• 模型上下文協議（MCP）提供協議規範。
• python-docx 庫用於 Word 文檔操作。
• FastMCP 為 Python MCP 實現提供了支持。

⚠️ 重要提示

此服務器與系統中的文檔文件交互。在任何 MCP 客戶端（如 Claude for Desktop）確認請求的操作之前，請始終驗證其適當性。