使用说明

项目简介

本项目是 Model Context Protocol (MCP) 服务器的实现，旨在通过AI助手简化与Microsoft Office应用程序（目前支持PowerPoint和Excel）的交互。它允许AI模型通过标准化的MCP协议，调用预定义的工具来操作Office文档，例如创建演示文稿、编辑幻灯片元素、处理Excel工作簿和单元格数据等。

主要功能点

PowerPoint MCP服务器:
- 演示文稿管理：创建、修改、保存演示文稿，管理幻灯片和模板。
- 元素操作：精细控制幻灯片中的文本、形状、图像、图表等元素，支持样式和格式设置。
- 财务图表集成：创建财务图表和对比表格，用于数据可视化（目前使用虚拟数据，可扩展至真实数据源）。
- 模板功能：应用和创建演示文稿模板。
Excel MCP服务器:
- 工作簿管理：连接到正在运行的Excel实例，列出和保存工作簿。
- 工作表操作：列出、添加工作表，访问指定工作表。
- 单元格和区域操作：读取和写入单元格及单元格区域的值，支持多种数据类型。

安装步骤

环境准备:
- 操作系统：Windows（必需）。
- Microsoft Office：已安装 PowerPoint 和/或 Excel。
- Python：3.7 或更高版本。

克隆仓库: 打开命令行工具，执行以下命令克隆仓库到本地：

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

安装依赖: 使用 'uv' 或 'pip' 安装 'pywin32' 依赖库：

uv pip install pywin32
# 或使用 pip
# pip install pywin32

运行 pywin32 后安装脚本 (管理员权限): 以管理员身份运行命令行工具，执行 'pywin32' 的后安装脚本，以确保 COM 组件正确安装：
```
python 您的Python环境路径\Scripts\pywin32_postinstall.py -install
```
注意: 将 '您的Python环境路径' 替换为您的Python环境实际安装路径。

服务器配置

要将这些MCP服务器集成到 MCP 客户端（例如 Claude），您需要在客户端的设置中配置MCP服务器信息。以下是针对 Claude 桌面应用的配置示例，其他 MCP 客户端的配置方式类似，关键是提供服务器的启动命令和参数。

在 Claude 桌面应用的设置中，找到 MCP服务器配置部分，添加以下 JSON 配置：

{
    "mcpServers": {
        "powerpoint_mcp_win32": {
            "command": "uv",
            "args": [
                "run",
                "mcp_powerpoint_server_win32.py"
            ],
            "cwd": "您的仓库路径"  // 请替换为您的仓库在本地的实际路径
        },
        "excel_mcp_win32": {
            "command": "uv",
            "args": [
                "run",
                "mcp_excel_server_win32.py"
            ],
            "cwd": "您的仓库路径"  // 请替换为您的仓库在本地的实际路径
        }
    }
}

配置参数说明:

'"powerpoint_mcp_win32"' 和 '"excel_mcp_win32"': 服务器名称，在客户端中用于标识不同的 MCP 服务器。您可以自定义名称。
'"command": "uv"': 启动服务器的命令。这里假设您使用 'uv' 运行 Python 脚本。如果您使用 'python'，则将 '"command"' 更改为 '"python"'。
'"args": [...]': 传递给命令的参数列表。
- '"run"': 'uv run' 或 'python -m runpy' 的子命令，用于运行 Python 脚本。
- '"mcp_powerpoint_server_win32.py"' 或 '"mcp_excel_server_win32.py"': 要运行的服务器脚本文件名。
'"cwd": "您的仓库路径"': 重要参数，指定服务器启动时的工作目录。必须替换为您的 'pptx-xlsx-mcp' 仓库在本地文件系统中的绝对路径。 例如 'C:\Users\YourName\Documents\pptx-xlsx-mcp'。

启动服务器:

配置完成后，当 MCP 客户端尝试连接到这些服务器时，客户端会根据您提供的配置自动启动服务器进程。您无需手动运行服务器脚本。

基本使用方法

配置并启动 MCP 服务器后，您可以通过 MCP 客户端（例如 Claude）以自然语言指令与 PowerPoint 和 Excel 进行交互。

PowerPoint 示例:

"创建一个关于市场分析的新幻灯片，标题为 '市场分析'，并添加一个显示收入增长的柱状图。"
"将标题字体放大，颜色改为蓝色。"
"在图表下方添加一个对比表格，比较三家公司。"

Excel 示例:

"打开 Q4 报告工作簿，读取 B2 到 B5 单元格的收入数据。"
"计算这些数字的总和，并将结果放入 B6 单元格。"
"创建一个名为 'Summary' 的新工作表，并将这些值复制到新工作表。"

更多使用示例和工具列表请参考仓库的 README.md 文件。

关键词