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%覆盖的完整办公自动化套件