MCP Microsoft Office

MCP微软办公软件

一台MCP服务器。多个用户。测试租户上的真实Microsoft 365流量。

______________________________________________________________________

问题

测试租户坐空了。静态测试数据不能执行真实的工作流程。当你需要能够发送真实电子邮件、安排真实会议和在真实团队渠道中协作的代理时，模拟和存根是不够的。

这解决了什么

该项目通过Graph API将任何兼容MCP的AI客户端连接到Microsoft 365。每个代理都作为不同的租户用户进行身份验证，并对真实数据执行实际操作。

• 117工具 跨12个模块：邮件、日历、文件、， Excel, 字, 幻灯片、团队、联系人、待办事项、组、人员、搜索
• 多用户：一台服务器支持整个团队，每台服务器都有独立的数据
• 实图API调用：每个操作都会击中实际租户，而不是模拟租户
• 安全：静态加密的令牌，第三方服务器上不存储凭据

______________________________________________________________________

建筑

                    ┌──────────────────┐
                    │  MCP Client      │
                    │  (Claude, etc.)  │
                    └────────┬─────────┘
                             │ JSON-RPC (stdin/stdout)
                    ┌────────▼─────────┐
                    │  MCP Adapter     │
                    │  (runs locally)  │
                    └────────┬─────────┘
                             │ HTTP + Bearer Token
                    ┌────────▼─────────┐
                    │  MCP Server      │
                    │  (local or       │
                    │   remote)        │
                    └────────┬─────────┘
                             │ Microsoft Graph API
                    ┌────────▼─────────┐
                    │  Microsoft 365   │
                    │  (your tenant)   │
                    └──────────────────┘

三个部分：

1. MCP客户端 --您与之交互的AI
2. MCP适配器 --将MCP协议转换为HTTP请求的Node.js进程（与客户端在同一台机器上运行）
3. MCP服务器 --处理身份验证并调用Microsoft Graph API（在本地或远程服务器上运行）

______________________________________________________________________

权限

服务器需要18个Microsoft Graph委托权限。十二项工作未经管理员同意。六项要求租户管理员同意。

无需管理员同意

需要管理员同意

未经管理员同意，您将获得邮件、日历、文件、Excel工作簿、Word文档、PowerPoint演示文稿、联系人、待办事项、聊天和基本团队频道操作。 经管理员同意，您可以添加人员目录搜索、组、频道成员管理和会议记录。

______________________________________________________________________

快速开始

先决条件

• Node.js 18+ (下载)
• 克劳德桌面 (下载)或另一个MCP客户端
• Microsoft 365帐户 （工作、学校或个人）

步骤1:Azure应用程序注册

1. 首选 Azure门户 > 微软Entra ID > 应用注册 > 新注册
2. 命名它 MCP-Microsoft-Office，使用您首选的帐户类型注册
3. 复制 应用程序（客户端）ID 和 目录（租户）ID
4. 首选 API权限 > 添加权限 > 微软图形 > 委托权限
5. 添加上面列出的18个权限
6. 如果您是租户管理员，请单击 授予管理员同意
7. 首选 认证 > 添加平台 > 网络

- 重定向URI: http://localhost:3000/api/auth/callback - 启用 允许公共客户端流

步骤2：克隆和配置

git clone https://github.com/Aanerud/MCP-Microsoft-Office.git
cd MCP-Microsoft-Office
npm install

复制 .env.example 到 .env 并填写您的Azure应用程序详细信息：

MICROSOFT_CLIENT_ID=your-client-id
MICROSOFT_TENANT_ID=your-tenant-id

步骤3：启动服务器并进行身份验证

npm run dev:web

打开 http://localhost:3000 在您的浏览器中。点击 使用Microsoft登录，登录并授予权限。然后单击 生成MCP令牌 并复制令牌。

步骤4：配置Claude桌面

编辑您的Claude Desktop配置：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

Claude Desktop的实际限制是每个MCP服务器约55个工具。该项目公开了117个工具，因此我们将它们分为三个共享相同适配器和后端的服务器：

{
  "mcpServers": {
    "microsoft-365": {
      "command": "node",
      "args": ["/path/to/MCP-Microsoft-Office/mcp-adapter.cjs"],
      "env": {
        "MCP_SERVER_URL": "http://localhost:3000",
        "MCP_BEARER_TOKEN": "paste-your-token-here",
        "MCP_MODULES": "search,mail,calendar,files,people,contacts,groups,query"
      }
    },
    "microsoft-365-teams": {
      "command": "node",
      "args": ["/path/to/MCP-Microsoft-Office/mcp-adapter.cjs"],
      "env": {
        "MCP_SERVER_URL": "http://localhost:3000",
        "MCP_BEARER_TOKEN": "paste-your-token-here",
        "MCP_MODULES": "teams,todo"
      }
    },
    "microsoft-365-office": {
      "command": "node",
      "args": ["/path/to/MCP-Microsoft-Office/mcp-adapter.cjs"],
      "env": {
        "MCP_SERVER_URL": "http://localhost:3000",
        "MCP_BEARER_TOKEN": "paste-your-token-here",
        "MCP_MODULES": "excel,word,powerpoint,files"
      }
    }
  }
}

MCP_MODULES 过滤适配器暴露的模块。省略它以显示所有117个工具（适用于没有工具盖的客户端）。

集 MCP_DEBUG=1 在 env 块以启用到stderr的诊断日志记录，这对于排除工具调度问题非常有用。

重新启动克劳德桌面。问： *“今天我的日历上有什么？”* 或 *“使用预算表创建Excel工作簿。”*

______________________________________________________________________

工具（117）

邮件（9）

日历（13）

文件（10）

Excel（30）

直接使用存储在OneDrive或SharePoint中的Excel工作簿，无需下载文件。所有操作都通过Microsoft Graph的工作簿API进行透明的会话管理。

单词（5）

创建、阅读和转换Word文档。文档由结构化JSON创建并存储在OneDrive中。阅读使用多库回退链：mammath（.docx的最佳HTML）→ 单词提取器（同时处理.doc和.docx）→ webUrl回退。二进制下载使用Graph测试版 /contentStream 用于可靠二进制传输的端点。

注： 一些SharePoint租户在上传后几秒钟内将上传的.docx文件转换为OLE2二进制格式。当这种情况发生时，客户端解析库无法读取文件。服务器优雅地返回 webUrl 因此用户可以在浏览器中打开文档。

PowerPoint（4）

创建、阅读和转换PowerPoint演示文稿。演示文稿由结构化幻灯片数据构建并存储在OneDrive中。阅读使用Graph HTML转换和jszip回退进行幻灯片级文本提取。

团队（21）

*（注： addChannelMember 仅适用于私人频道。标准频道自动包括所有团队成员。)*

联系人（6）

待办事项（11）

团体（4）

人（3）

搜索（1）

______________________________________________________________________

多用户

每个用户都独立进行身份验证。服务器通过用户身份隔离所有数据。

  Alice (alice@contoso.com)          Bob (bob@contoso.com)
  ├─ Her own Microsoft tokens        ├─ His own Microsoft tokens
  ├─ Her own session                  ├─ His own session
  └─ Claude Desktop (her laptop)     └─ Claude Desktop (his PC)

              Complete data isolation.
         Alice never sees Bob's data.

对于 使用多个代理进行自动化测试，使用ROPC（资源所有者密码凭据）流以编程方式进行身份验证：

# Start the server
npm run dev:web

# Run the E2E test suite (authenticates 3 users via ROPC)
node tests/run-all.cjs

该测试套件对多个用户进行身份验证，然后在12个模块和5个跨模块工作流中练习所有117个工具。看 tests/ 为了全面实施。

______________________________________________________________________

E2E测试套件

该项目包括一个涵盖所有117个工具的全面测试套件。

# Run all tests (requires server running)
node tests/run-all.cjs

# Run a single module
node tests/run-all.cjs --bucket mail --buckets-only

# Run only workflows
node tests/run-all.cjs --workflows-only

测试结构：

tests/
  lib/           Shared auth, HTTP client, reporter
  buckets/       One file per module (12 files, 117 tools)
  workflows/     Cross-module tests (5 files)
  run-all.cjs    Master runner

测试通过ROPC进行身份验证（无需手动令牌管理），并在约100秒内运行。

______________________________________________________________________

环境变量

复制 .env.example 到 .env 并配置：

______________________________________________________________________

部署

本地（建议入门）

npm install
npm run dev:web

Azure应用服务

看 docs/azure-deployment.md 使用GitHub Actions进行CI/CD部署。

______________________________________________________________________

安全

• 加密存储：所有使用AES-256静态加密的Microsoft令牌
• 没有客户机密：使用公共客户端流（PKCE）进行桌面身份验证
• 令牌隔离：每个用户的令牌分别存储在不同的加密密钥中
• 速率限制：内置速率限制可防止滥用
• CORS保护：生产中的起源异物种
• 会话到期：会话将在24小时后过期

生产清单

• \[\]设置 NODE_ENV=production
• \[\]设置 DEVICE_REGISTRY_ENCRYPTION_KEY （32字节）
• \[\]设置 JWT_SECRET （强随机字符串）
• \[\]设置 CORS_ALLOWED_ORIGINS
• \[\]使用带有有效证书的HTTPS

______________________________________________________________________

项目结构

MCP-Microsoft-Office/
├── mcp-adapter.cjs          MCP protocol adapter (runs locally with Claude Desktop)
├── src/
│   ├── api/                 Express routes and controllers
│   ├── auth/                MSAL authentication (OAuth2, ROPC, token exchange)
│   ├── core/                Services (cache, storage, tools, error handling)
│   ├── graph/               Microsoft Graph API services
│   │   ├── graph-client.cjs   HTTP client with retry, binary support, sessions
│   │   ├── files-service.cjs  OneDrive file operations
│   │   ├── excel-service.cjs  Workbook API (sessions, ranges, tables, functions)
│   │   ├── word-service.cjs   Word create/read (docx + mammoth + word-extractor)
│   │   └── powerpoint-service.cjs  PPT create/read (pptxgenjs + jszip)
│   └── modules/             Feature modules (mail, calendar, excel, word, powerpoint, etc.)
├── public/                  Web UI for authentication
└── tests/                   E2E test suite (gitignored)

______________________________________________________________________

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 提交拉取请求

______________________________________________________________________

许可证

MIT许可证——见 许可证 文件。