Mcp Office Excel

MCP Office

面向 Microsoft Office 的本地优先、可治理 MCP 服务——为希望像处理代码一样处理 Office 文件的开发者打造。

---

这是什么？

MCP Office 是一套 Model Context Protocol 服务，可将 Microsoft Office 功能作为受治理、确定性的工具调用开放出来。每个服务都在 Windows 上本地运行，连接到你的 MCP 客户端（Claude Desktop、VS Code Copilot 或任何兼容 MCP 的客户端），让你能够结构化地控制 Office 文件——无需使用应用内 AI 助手。

这不是 Copilot 的替代品。 它是一个开发者优先的 Office 自动化执行层。

---

软件包

✅ 现已推出

软件包	功能	安装	工具数
excelmcp	读取、写入、设置样式、验证和导出 Excel 工作簿	pip install mcp-office	65
pptmcp	创建、编辑、审阅和导出 PowerPoint 演示文稿。包含可机器验证幻灯片规范的 Output Contract 框架	pip install mcp-office	51
wordmcp	Word 文档的模板组装、修订跟踪支持和结构化 QA	pip install mcp-office	50

🚧 即将推出

软件包	状态
mailmcp	已集成到当前源码分发包中；Windows Outlook UAT 和已发布制品验证待完成

MailMCP 现已包含在仓库统一的 mcp-office 源码分发包中，但当前已发布的 PyPI 制品尚未声明支持 MailMCP。Windows Outlook UAT 和发布验证尚未完成，请参阅 mailmcp/README.md 了解源码验证。

新软件包将在完成验证周期后陆续添加。请参阅 ROADMAP.md。

---

快速开始

前提条件

• Windows 10 或 11
• Python 3.11 或更高版本（python --version）
• Claude Desktop 或安装了 GitHub Copilot 的 VS Code
• Microsoft Office（Excel / PowerPoint / Word）——COM 支持的工具（设置样式、导出 PDF、修订跟踪）需要此软件
• 经典版 Microsoft Outlook 桌面应用——MailMCP 需要此软件

安装

PyPI 提示： PyPI 上的 excelmcp 是一个无关的第三方软件包。请勿运行 pip install excelmcp——否则安装的会是陌生人的代码。已发布的套件软件包是 mcp-office。

pip install mcp-office

或者克隆仓库并从源码安装整合套件（包含 MailMCP 和 Windows COM 支持）：

git clone https://github.com/dosev-ai/mcp-office.git
cd mcp-office
python -m venv .venv
.venv\Scripts\activate
python -m pip install -e ".[com]"

配置 Claude Desktop

打开 %APPDATA%\Claude\claude_desktop_config.json（如果文件不存在，请创建），并添加已安装的服务：

{
  "mcpServers": {
    "excel-excelmcp": {
      "command": "python",
      "args": ["-m", "excelmcp.server"],
      "env": {
        "EXCEL_ALLOWLIST_ROOTS": "C:\\path\\to\\your\\files",
        "EXCEL_ENABLE_WRITE": "true"
      }
    },
    "powerpoint-pptmcp": {
      "command": "python",
      "args": ["-m", "pptmcp.server"],
      "env": {
        "PPT_ALLOWLIST_ROOTS": "C:\\path\\to\\your\\files",
        "PPT_ENABLE_WRITE": "true"
      }
    },
    "word-wordmcp": {
      "command": "python",
      "args": ["-m", "wordmcp.server"],
      "env": {
        "WORD_ALLOWLIST_ROOTS": "C:\\path\\to\\your\\files",
        "WORD_ENABLE_WRITE": "true"
      }
    }
  }
}

将 C:\\path\\to\\your\\files 替换为 Office 文件所在的目录。保存后重启 Claude Desktop。

验证

在 Claude Desktop 中发送：

Call capabilities() on excel-excelmcp
Call capabilities() on powerpoint-pptmcp
Call capabilities() on word-wordmcp

每个服务都应返回一个工具列表（Excel 为 65 个，PowerPoint 为 51 个，Word 为 50 个）。如果缺少某个服务，请检查 python 是否指向安装了 mcp-office 的虚拟环境。

各软件包的完整指南：excelmcp/README.md · pptmcp/README.md · wordmcp/README.md · mailmcp/README.md （已集成源码；等待发布）

详细分步指南：docs/quickstart.md

---

要求

要求	说明
Windows 10 或 11	COM 自动化需要 Windows
Python 3.11+	使用 python --version 确认
Microsoft Office	COM 相关工具（样式设置、导出 PDF、跟踪修订）必需。只读 docx/xlsx/pptx 工具无需 Office。
Classic Outlook 桌面版	MailMCP 必需。Windows Outlook UAT 和已发布构建产物验证通过前，MailMCP 仍处于待发布状态。
MCP 客户端	Claude Desktop 或 带 Copilot 的 VS Code

---

架构

Your MCP client (Claude Desktop / VS Code Copilot / other)
        │
        │  MCP stdio protocol
        ↓
  MCP Office servers (local Python processes)
   ├─ excelmcp    — Excel automation (live)
   ├─ pptmcp      — PowerPoint automation (live)
   ├─ wordmcp     — Word automation (live)
   └─ mailmcp     — Outlook automation (source-integrated; release pending)
        │
        │  COM / Outlook COM / openpyxl / python-pptx / python-docx
        ↓
  Microsoft Office (local installation)

每个服务都是独立运行的本地 stdio MCP 进程。MCP Office 不会添加托管服务；Microsoft Office 和你的 MCP 客户端/模型仍可能有各自的数据同步与处理边界。

---

参与贡献

本项目正在积极开发中。目前最佳的贡献方式：

1. 试用任意软件包（excelmcp、pptmcp、wordmcp），并提交首次运行报告
2. 通过 GitHub Issues 报告 Bug
3. 在 GitHub Discussions 提问或分享你构建的内容

开发指南请参阅 CONTRIBUTING.md。

---

许可证

MIT——请参阅 LICENSE。