MCP Server Office

🚀 MCP 服務器辦公（中文版）

這是一個模型上下文協議（MCP）服務器，主要提供微軟 Word (docx) 文件的讀寫功能，能滿足對 docx 文件的多種操作需求。

🚀 快速開始

安裝

使用 pip 安裝：

pip install mcp-server-office

啟動服務

啟動 MCP 服務器：

mcp-server-office

或者使用 uv 運行：

uvx mcp-server-office

📦 安裝指南

系統要求

• Python >= 3.12
• 依賴：
  • mcp[cli] >= 1.2.0
  • python-docx >= 1.1.2

💻 使用示例

可用工具

1. read_docx

讀取 docx 文件的完整內容，包括表格和圖片。

• 輸入：path（字符串）- 對應文件的絕對路徑
• 注意：圖片將轉換為 [Image] 佔位符，修訂記錄不會顯示

2. write_docx

創建包含指定內容的新 docx 文件。

• 輸入：
  • path（字符串）- 新文件的絕對路徑
  • content（字符串）- 寫入文件的內容
• 注意：使用雙行換行符表示新段落，表格使用 [Table] 標籤和 | 分隔符

3. edit_docx_paragraph

在 docx 文件的指定段落中進行文本替換。

• 輸入：
  • path（字符串）- 要編輯的文件路徑
  • edits（數組）- 包含搜索/替換信息和段落索引的字典列表
    • paragraph_index（數字）- 指定要修改的段落的 0 基數索引
    • search（字符串）- 在指定段落中查找的文本
    • replace（字符串）- 要替換的文本
• 注意：每個搜索字符串在指定段落內必須唯一匹配

4. edit_docx_insert

在 docx 文件中插入新的段落。

• 輸入：
  • path（字符串）- 要編輯的文件路徑
  • inserts（數組）- 包含要插入文本和可選段落索引的字典列表
    • text（字符串）- 作為新段落插入的文本
    • paragraph_index（數字，可選）- 插入位置的段落 0 基數索引。未指定則插入在末尾。