Office Whisperer

🚀 辦公助手 v4.0

藉助143種專業工具，全面覆蓋微軟辦公套件，通過人工智能驅動的自動化功能，徹底改變你的辦公流程。無論是創建Excel電子表格、Word文檔、PowerPoint演示文稿，還是管理Outlook，都能通過Claude Desktop以自然語言輕鬆完成。真正實現100%辦公功能覆蓋，打造完整專業的辦公解決方案！

🚀 快速開始

安裝

git clone https://github.com/consigcody94/office-whisperer.git
cd office-whisperer
npm install
npm run build

Claude Desktop設置

將以下內容添加到你的 claude_desktop_config.json 文件中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "office-whisperer": {
      "command": "node",
      "args": ["/absolute/path/to/office-whisperer/dist/mcp-server.js"]
    }
  }
}

重啟Claude Desktop。

✨ 主要特性

v4.0版本新增內容

🎉 重大擴展：實現100%辦公功能覆蓋！

專業工具數量從63個增加到143個（增長127%）：

• 45個Excel工具（新增24個） - 新增功能：Power Query、單變量求解、數據表、方案管理器、Excel表格、表單控件、圖像/形狀/SmartArt圖形、頁面設置、頁眉/頁腳、跟蹤更改、共享。
• 35個Word工具（新增19個） - 新增功能：參考文獻（APA/MLA/芝加哥/哈佛/IEEE格式）、引用、索引、表單字段、內容控件、SmartArt圖形、公式（LaTeX/MathML格式）、符號、可訪問性檢查器、替代文本、數字簽名、文檔保護、主控文檔、題注、首字下沉、水印。
• 30個PowerPoint工具（新增17個） - 新增功能：SmartArt圖形、圖標、3D模型、縮放（摘要/幻燈片/節）、屏幕錄製、即時網頁、PowerPoint設計器、評論/@提及、演示者教練、即時字幕、墨跡註釋、網格/參考線、自定義放映、動畫窗格、高級幻燈片母版、主題、模板。
• 33個Outlook工具（新增20個） - 新增功能：完整的IMAP操作（讀取/刪除/移動帶有附件的電子郵件）、共享郵箱、委託訪問、自動回覆、便箋、日記、RSS訂閱源、數據文件、快速步驟、對話視圖、清理、類別、簽名、自動完成、高級郵件合併。

辦公功能覆蓋率從40%提升到100%！

選擇辦公助手的理由

• 🎯 100%辦公功能覆蓋 - 143種專業工具涵蓋了辦公軟件的所有主要功能。
• 💬 自然語言界面 - 通過Claude Desktop的對話方式控制辦公軟件。
• 🔒 適用於生產環境的TypeScript - 企業級、類型安全的代碼，擁有全面的接口。
• 📦 完全類型安全 - 所有143種工具都有強類型接口，確保可靠性。
• 🚀 支持所有主要功能 - 從基本格式設置到高級自動化操作。
• 🔧 經過實戰檢驗的庫 - 基於ExcelJS、docx、PptxGenJS、nodemailer、imap構建。
• 🆓 免費且開源 - 採用MIT許可證，無需訂閱，永久免費使用。
• 🔐 隱私至上 - 本地文件處理，無需上傳到雲端。
• ⚡ 跨平臺支持 - 可在Windows、macOS和Linux系統上運行。

📦 安裝指南

從源代碼構建

# 安裝依賴
npm install

# 開發模式（即時監聽）
npm run dev

# 生產環境構建
npm run build

# 運行測試（如果已實現）
npm test

添加新工具

1. 在 src/types.ts 中添加類型定義。
2. 在相應的生成器中實現方法。
3. 將工具定義添加到 mcp-server.ts 的工具數組中。
4. 在 callTool() 方法中添加處理程序。
5. 更新README文檔。

💻 使用示例

Excel - 高級銷售儀表盤

"創建一個包含數據透視表、條件格式和圖表的銷售儀表盤"

{
  "filename": "sales_dashboard.xlsx",
  "sheets": [{
    "name": "Data",
    "columns": [
      { "header": "Region", "key": "region", "width": 15 },
      { "header": "Revenue", "key": "revenue", "width": 15 },
      { "header": "Target", "key": "target", "width": 15 },
      { "header": "% of Target", "key": "percent", "width": 15 }
    ],
    "data": [
      ["North", 125000, 100000, "=B2/C2"],
      ["South", 98000, 120000, "=B3/C3"],
      ["East", 156000, 140000, "=B4/C4"],
      ["West", 142000, 130000, "=B5/C5"]
    ]
  }]
}

然後應用條件格式：

{
  "filename": "sales_dashboard.xlsx",
  "sheetName": "Data",
  "range": "D2:D5",
  "rules": [{
    "type": "colorScale",
    "gradient": {
      "start": "FF0000",
      "middle": "FFFF00",
      "end": "00FF00"
    }
  }]
}

Word - 帶目錄的專業報告

"創建一個包含目錄、執行摘要和圖表的季度報告"

{
  "filename": "Q4_Report.docx",
  "sections": [{
    "children": [
      { "type": "paragraph", "text": "Q4 2024 Performance Report", "heading": "Heading1" },
      { "type": "toc", "title": "Table of Contents" },
      { "type": "pageBreak" },
      { "type": "paragraph", "text": "Executive Summary", "heading": "Heading1" },
      {
        "type": "paragraph",
        "text": "Revenue increased 35% year-over-year...",
        "alignment": "justified"
      }
    ]
  }]
}

PowerPoint - 動畫演示文稿

"創建一個包含過渡效果和動畫的產品發佈演示文稿"

{
  "filename": "product_launch.pptx",
  "theme": "dark",
  "slides": [
    {
      "layout": "title",
      "title": "Revolutionary Product Launch",
      "subtitle": "Q1 2025"
    },
    {
      "layout": "content",
      "title": "Key Features",
      "content": [{
        "type": "text",
        "text": "• AI-Powered Analytics\n• Real-time Collaboration\n• Cloud Integration",
        "x": 1,
        "y": 2,
        "fontSize": 24,
        "bullet": true
      }]
    }
  ]
}

然後添加過渡效果：

{
  "filename": "product_launch.pptx",
  "slideNumber": 1,
  "transition": {
    "type": "fade",
    "duration": 500
  }
}

Outlook - 自動化郵件營銷活動

"向客戶列表發送帶有附件的個性化電子郵件"

{
  "to": "client@company.com",
  "subject": "Exclusive Q1 Offer - 30% Discount",
  "body": "<h1>Special Offer Just for You!</h1><p>As a valued client...</p>",
  "html": true,
  "attachments": [{
    "filename": "Q1_Catalog.pdf",
    "path": "/path/to/catalog.pdf"
  }],
  "priority": "high",
  "smtpConfig": {
    "host": "smtp.gmail.com",
    "port": 587,
    "auth": {
      "user": "your-email@gmail.com",
      "pass": "your-app-password"
    }
  }
}

📚 詳細文檔

完整工具參考

Excel工具（45個）

Word工具（35個）

PowerPoint工具（30個）

Outlook工具（33個）

實際應用案例

1. 財務報告自動化

# 創建帶有公式的Excel文件
create_excel → add_formula → conditional_formatting → add_chart → freeze_panes

結果：具有動態計算、視覺指標和鎖定標題的專業財務報告。

2. 文檔郵件合併活動

# Word郵件合併工作流程
create_word (模板) → word_mail_merge (數據) → word_to_pdf (轉換)

結果：1000多份PDF格式的個性化信件，可隨時分發。

3. 營銷演示文稿流程

# PowerPoint自動化
create_powerpoint → ppt_add_transition → ppt_add_animation → ppt_add_media → ppt_export_pdf

結果：帶有嵌入式演示視頻的精美動畫銷售演示文稿。

4. 電子郵件營銷活動管理

# Outlook自動化
outlook_create_meeting → outlook_send_email → outlook_set_rule

結果：安排客戶會議，發送跟進電子郵件，並自動組織收件箱。

高級示例

Excel：複雜公式自動化

// 添加高級公式
{
  "filename": "analysis.xlsx",
  "sheetName": "Calculations",
  "formulas": [
    { "cell": "E2", "formula": "=VLOOKUP(A2,Products!A:C,2,FALSE)" },
    { "cell": "F2", "formula": "=SUMIFS(Sales!C:C,Sales!A:A,A2,Sales!B:B,\">\"&TODAY()-30)" },
    { "cell": "G2", "formula": "=INDEX(Prices!B:B,MATCH(A2,Prices!A:A,0))" },
    { "cell": "H2", "formula": "=IF(F2>10000,\"High\",IF(F2>5000,\"Medium\",\"Low\"))" }
  ]
}

Word：多節專業文檔

{
  "filename": "technical_spec.docx",
  "sections": [
    {
      "properties": {
        "page": {
          "margin": { "top": 1440, "right": 1440, "bottom": 1440, "left": 1440 }
        }
      },
      "headers": [{
        "type": "default",
        "children": [{ "type": "paragraph", "text": "Technical Specification v2.0" }]
      }],
      "footers": [{
        "type": "default",
        "children": [{ "type": "paragraph", "text": "Confidential", "alignment": "right" }]
      }],
      "children": [
        { "type": "paragraph", "text": "System Architecture", "heading": "Heading1" },
        {
          "type": "table",
          "rows": [
            {
              "cells": [
                { "children": [{ "type": "paragraph", "text": "Component" }] },
                { "children": [{ "type": "paragraph", "text": "Technology" }] },
                { "children": [{ "type": "paragraph", "text": "Status" }] }
              ],
              "tableHeader": true
            }
          ]
        }
      ]
    }
  ]
}

PowerPoint：交互式培訓模塊

{
  "filename": "training.pptx",
  "theme": "colorful",
  "slides": [
    {
      "layout": "title",
      "title": "Employee Onboarding",
      "subtitle": "Welcome to the Team!",
      "notes": "Welcome participants and introduce training agenda"
    },
    {
      "layout": "content",
      "title": "Company Values",
      "content": [
        {
          "type": "text",
          "text": "Innovation\nIntegrity\nCollaboration\nExcellence",
          "x": 1,
          "y": 2,
          "fontSize": 28,
          "bullet": { "type": "arrow" }
        },
        {
          "type": "image",
          "path": "/images/company_logo.png",
          "x": 6,
          "y": 2,
          "w": 3,
          "h": 3
        }
      ],
      "notes": "Emphasize core company values with real-world examples"
    }
  ]
}

🔧 技術細節

項目結構

office-whisperer/
├── src/
│   ├── generators/
│   │   ├── excel-generator.ts      # 45個Excel方法
│   │   ├── word-generator.ts       # 35個Word方法
│   │   ├── powerpoint-generator.ts # 30個PowerPoint方法
│   │   └── outlook-generator.ts    # 33個Outlook方法
│   ├── types.ts                    # 143種工具的接口
│   └── mcp-server.ts               # 包含143種工具的MCP服務器
├── dist/                            # 編譯後的JavaScript文件
├── package.json
├── tsconfig.json
└── README.md

🤝 貢獻

歡迎貢獻代碼！未來可擴展的領域包括：

• Excel：VBA宏、Power Pivot、外部數據連接、多維數據集公式。
• Word：高級字段代碼、構建基塊、XML映射。
• PowerPoint：自定義XML、嵌入字體、視頻編輯。
• Outlook：高級規則引擎、自定義表單、投票按鈕。
• 跨應用：辦公自動化工作流程、應用間數據鏈接、統一搜索。

具體貢獻指南請參考 CONTRIBUTING.md。

📄 許可證

本項目採用MIT許可證，詳情請參閱 LICENSE 文件。

🌟 Star歷史

如果辦公助手v4.0為你節省了時間，不妨給它一個 ⭐！

🔗 鏈接

• 倉庫地址：https://github.com/consigcody94/office-whisperer
• MCP協議：https://modelcontextprotocol.io
• 問題反饋：https://github.com/consigcody94/office-whisperer/issues
• 討論區：https://github.com/consigcody94/office-whisperer/discussions

📈 統計信息

• 4種辦公應用程序共143種專業工具
• 100%覆蓋專業辦公功能
• 潛在市場：12億以上辦公用戶
• 零成本 - 完全免費且開源
• 適用於生產環境 - 基於經過實戰檢驗的庫（ExcelJS、docx、PptxGenJS、nodemailer、imap）構建
• 4200多行TypeScript自動化代碼
• 從v3.0到v4.0增長127%（新增80種工具）

由TypeScript和模型上下文協議精心打造 ❤️

版本4.0.0 - 實現100%覆蓋的完整辦公自動化套件