Microsoft Office MCP 服务器

此仓库包含模型上下文协议 (MCP) 服务器，用于通过 AI 辅助与 Microsoft Office 应用程序交互。目前支持的应用程序：

• PowerPoint：创建和操作演示文稿
• Excel：与工作簿和电子表格交互

两个服务器都使用 pywin32 进行 COM 自动化，从而可以直接与正在运行的 Office 应用程序交互。

前提条件

• Windows 操作系统
• 已安装 Microsoft Office（PowerPoint 和/或 Excel）
• Python 3.7+
• pywin32 包

安装

1. 克隆仓库：

git clone https://github.com/jenstangen1/mcp-pptx.git
cd mcp-pptx

2. 使用 uv 安装依赖项：

uv pip install pywin32

3. 使用管理员权限运行 pywin32 安装后脚本：

python C:\path\to\your\env\Scripts\pywin32_postinstall.py -install

使用 Claude 进行设置

要将这些 MCP 服务器与 Claude 集成，请将以下配置添加到您的 Claude Desktop 应用程序设置：

{
    "mcpServers": {
        "powerpoint_mcp_win32": {
            "command": "uv",
            "args": [
                "run",
                "mcp_powerpoint_server_win32.py"
            ],
            "cwd": "C:\\path\\to\\your\\workspace"
        },
        "excel_mcp_win32": {
            "command": "uv",
            "args": [
                "run",
                "mcp_excel_server_win32.py"
            ],
            "cwd": "C:\\path\\to\\your\\workspace"
        }
    }
}

注意：将 C:\\path\\to\\your\\workspace 替换为您的实际工作区路径。

PowerPoint MCP 服务器

PowerPoint 服务器为 AI 模型提供了一个全面的 API，用于与 PowerPoint 演示文稿交互，支持高级格式、财务图表和数据集成。

特性

演示文稿管理

• 创建和修改 PowerPoint 演示文稿
• 添加、删除和修改幻灯片
• 从工作区保存和加载演示文稿
• 模板管理系统

元素操作

• 对幻灯片元素（文本、形状、图像、图表）进行细粒度控制
• 高级形状创建和样式设置
• 元素定位和分组
• 形状之间的连接线

财务集成

• 创建财务图表（折线图、条形图、柱状图、饼图、瀑布图等）
• 生成比较表
• 支持各种财务指标：
  • 收入
  • EBITDA（息税折旧摊销前利润）
  • 利润
  • 资产
  • 权益
  • 增长率
  • 利润率
• 目前使用虚拟数据，计划集成 Proff API 以获取挪威公司数据
• 可通过 API 自定义来适应其他财务数据提供商

样式和格式设置

• 丰富的文本格式
• 形状样式（填充、渐变、轮廓）
• 图表自定义
• 背景颜色和效果

注意：您可能需要修改目录路径以匹配您的安装位置。

可用的 MCP 工具

演示文稿管理

• list_presentations：列出工作区中的所有 PowerPoint 文件
• upload_presentation：将新的演示文稿上传到工作区
• save_presentation：保存当前的演示文稿

幻灯片操作

• add_slide：向演示文稿添加新的幻灯片
• delete_slide：从演示文稿中删除幻灯片
• get_slide_count：获取演示文稿中幻灯片的总数
• analyze_slide：分析幻灯片的内容
• set_background_color：设置幻灯片的背景颜色

元素操作

• add_text：向幻灯片添加文本
• add_shape：向幻灯片添加形状
• edit_element：编辑元素的属性
• style_element：将样式应用于元素
• connect_shapes：用连接器连接两个形状
• find_element：根据条件查找幻灯片上的元素

财务工具

• get_company_financials：获取公司的财务数据（目前返回虚拟数据）
• create_financial_chart：在幻灯片上创建财务图表
• create_comparison_table：创建公司比较表

注意： 财务工具目前使用虚拟数据。未来版本计划与 Proff API 集成，以自动获取挪威公司数据。用户可以修改代码以连接到本地或首选的财务数据提供商。

模板操作

• list_templates：列出所有可用的模板
• apply_template：将模板应用于演示文稿
• create_slide_from_template：从模板创建新的幻灯片
• save_as_template：将幻灯片另存为模板

调试工具

• debug_element_mappings：调试工具，用于检查幻灯片的元素映射

用法

与 Claude 交互

在 Claude Desktop 应用程序中配置 MCP 服务器后，您可以通过自然语言命令与 PowerPoint 和 Excel 交互。以下是一些示例：

PowerPoint 示例

你：创建一个新幻灯片，标题为“市场分析”，并添加一个显示收入增长的条形图。

Claude：我将帮助您创建带有标题和图表的幻灯片。我将：
1. 添加一个新幻灯片
2. 添加标题文本
3. 创建一个收入图表

[Claude 将按顺序使用 MCP 工具：
- add_slide
- add_text
- create_financial_chart]

你：将标题放大并将颜色更改为蓝色。

Claude：我将修改标题的格式。
[Claude 将使用：
- find_element（查找标题）
- edit_element（更新格式）]

你：在图表下方添加一个比较三家公司的比较表。

Claude：我将在现有图表下方添加一个比较表。
[Claude 将使用：
- create_comparison_table]

Excel 示例

你：打开 Q4 报告并显示单元格 B2 到 B5 中的收入数字。

Claude：我将帮助您检索这些收入数字。
[Claude 将使用：
- list_open_workbooks（查找工作簿）
- get_range_values（读取指定的单元格）]

你：计算这些数字的总和并将其放入单元格 B6 中。

Claude：我将计算总和并将其写入 B6。
[Claude 将使用：
- get_range_values（获取数字）
- set_cell_value（写入总和）]

你：创建一个名为“摘要”的新工作表并将这些值复制到那里。

Claude：我将创建一个新工作表并复制数据。
[Claude 将使用：
- add_worksheet
- get_range_values（从源）
- set_range_values（到目标）]

工作原理

1. 自然语言理解

   • Claude 解释您的请求并将其分解为特定操作
   • 它理解先前交互的上下文
   • 它可以处理复杂的、多步骤的操作

2. 工具选择

   • Claude 自动为每个任务选择合适的 MCP 工具
   • 它可以将多个工具链接在一起以进行复杂的操作
   • 它处理错误情况并提供反馈

3. 上下文管理

   • Claude 维护以下上下文：
     • 当前打开的文件
     • 最近的操作
     • 选定的元素
     • 用户偏好

4. 错误处理

   • 如果操作失败，Claude 将：
     • 解释出了什么问题
     • 提出替代方案
     • 帮助解决常见问题

最佳实践

1. 具体

   • 在相关时提及幻灯片编号
   • 在 Excel 中指定确切的单元格范围
   • 清楚地描述所需的格式

2. 复杂操作

   • 将复杂请求分解为步骤
   • 确认中间结果
   • 根据需要要求调整

3. 故障排除

   • 确保 PowerPoint/Excel 正在运行
   • 检查文件权限
   • 验证 COM 自动化是否正常工作
   • 如果需要，运行 pywin32_postinstall.py

示例工作流程

创建财务演示文稿

你：创建一个关于 Q4 财务结果的新演示文稿。
Claude：我将创建一个带有标题幻灯片的新演示文稿。

你：添加过去 4 个季度的收入图表。
Claude：我将创建一个新幻灯片，其中包含显示季度收入的图表。

你：现在添加与我们竞争对手的比较。
Claude：我将添加一个包含您和竞争对手的关键指标的比较表。

分析 Excel 数据

你：显示 Q4 分析工作簿中的所有工作表。
Claude：我将列出该工作簿中的所有工作表。

你：在 B 列中找到最高的收入值。
Claude：我将扫描 B 列并找到最大值。

你：创建前 5 个值的摘要。
Claude：我将创建一个包含前 5 个收入数字的新工作表。

目录结构

pptx-mcp/
├── mcp_powerpoint_server.py  # 主要服务器实现
├── requirements.txt          # Python 依赖项
├── presentations/           # 演示文稿的工作区
│   └── templates/          # 模板存储
└── README.md               # 此文件

依赖项

• python-pptx：PowerPoint 文件操作
• Pillow：图像处理
• numpy：数值运算
• MCP SDK：模型上下文协议实现

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

此项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

Excel MCP 服务器

Excel 服务器提供通过 AI 辅助与 Excel 工作簿、工作表和单元格数据交互的工具。

特性

工作簿管理

• 连接到正在运行的 Excel 实例
• 列出打开的工作簿
• 以各种格式保存工作簿（.xlsx、.xlsm、.xlsb、.xls）

工作表操作

• 列出工作簿中的工作表
• 添加新的工作表
• 按名称或索引访问工作表

单元格和范围操作

• 读取和写入单个单元格值
• 获取和设置单元格范围的值
• 处理各种数据类型（文本、数字、日期、货币）
• 自动转换日期和货币值的类型

可用的 MCP 工具

工作簿管理

• list_open_workbooks：列出所有当前打开的 Excel 工作簿
• save_workbook：将工作簿保存到磁盘，并可选择格式

工作表操作

• list_worksheets：列出工作簿中的所有工作表
• add_worksheet：向工作簿添加新的工作表
• get_worksheet：按名称或索引获取工作表

单元格和范围操作

• get_cell_value：读取单个单元格的值
• set_cell_value：设置单个单元格的值
• get_range_values：从单元格范围读取值
• set_range_values：设置单元格范围的值

注意事项

• 两个服务器都需要 Windows 和各自的 Microsoft Office 应用程序
• 服务器与应用程序的正在运行的实例交互
• COM 自动化需要正确初始化；如果遇到与 COM 相关的错误，请运行安装后脚本
• 为了更好地处理常量，请考虑使用 makepy 生成 Office 常量