MCP 服务器

Enhanced Outlook MCP Server

通过 Graph API 将 Claude 连接到 Microsoft Outlook，提供全面的电子邮件、日历、文件夹管理和规则创建功能。

README

增强型 Outlook MCP 服务器

这是一个增强的、模块化的 Outlook MCP (模型上下文协议) 服务器实现，它通过 Microsoft Graph API 将 Claude 连接到 Microsoft Outlook。该服务器提供了一套强大的工具，用于电子邮件、日历、文件夹管理和规则创建。

功能

完整的身份验证系统: 使用 Microsoft Graph API 的 OAuth 2.0 身份验证，具有令牌刷新和多用户支持
电子邮件管理: 列出、搜索、读取、发送和组织电子邮件，支持附件
日历集成: 创建、修改和管理日历事件，并跟踪与会者
文件夹组织: 创建、管理和导航电子邮件文件夹
规则引擎: 创建和管理复杂的邮件处理规则
模块化架构: 清晰的关注点分离，以实现更好的可维护性和可扩展性
增强的错误处理: 详细的错误消息和日志记录
测试模式: 模拟响应，用于在没有真实 API 调用的情况下进行测试
速率限制: 通过内置的速率限制防止 API 节流
多环境配置: 支持开发、测试和生产环境

目录结构

/enhanced-outlook-mcp/
├── index.js                     # 主入口点
├── config.js                    # 配置设置
├── .env.example                 # 示例环境变量
├── auth/                        # 身份验证模块
│   ├── index.js                 # 身份验证导出
│   ├── token-manager.js         # 令牌存储和刷新
│   ├── multi-user-support.js    # 多用户支持
│   └── tools.js                 # 与身份验证相关的工具
├── email/                       # 电子邮件功能
│   ├── index.js                 # 电子邮件导出
│   ├── list.js                  # 列出电子邮件
│   ├── search.js                # 搜索电子邮件
│   ├── read.js                  # 读取电子邮件
│   ├── send.js                  # 发送电子邮件
│   └── attachments.js           # 处理电子邮件附件
├── calendar/                    # 日历功能
│   ├── index.js                 # 日历导出
│   ├── create-event.js          # 创建日历事件
│   ├── list-events.js           # 列出日历事件
│   ├── update-event.js          # 更新日历事件
│   └── delete-event.js          # 删除日历事件
├── folder/                      # 文件夹管理
│   ├── index.js                 # 文件夹导出
│   ├── list.js                  # 列出文件夹
│   ├── create.js                # 创建文件夹
│   └── move.js                  # 在文件夹之间移动项目
├── rules/                       # 邮件规则功能
│   ├── index.js                 # 规则导出
│   ├── create.js                # 创建邮件规则
│   ├── list.js                  # 列出邮件规则
│   └── delete.js                # 删除邮件规则
└── utils/                       # 实用程序函数
    ├── graph-api.js             # Microsoft Graph API 助手
    ├── odata-helpers.js         # OData 查询构建
    ├── logger.js                # 日志记录实用程序
    ├── rate-limiter.js          # API 速率限制
    └── mock-data/               # 测试模式模拟数据
        ├── emails.js            # 模拟电子邮件数据
        ├── folders.js           # 模拟文件夹数据
        ├── calendar.js          # 模拟日历数据
        └── rules.js             # 模拟规则数据

安装

克隆存储库:

git clone https://github.com/your-username/enhanced-outlook-mcp.git
cd enhanced-outlook-mcp

安装依赖项:
```
npm install
```
基于 .env.example 创建一个 .env 文件，其中包含您的 Microsoft 应用程序注册详细信息:
```
MS_CLIENT_ID=your_client_id
MS_CLIENT_SECRET=your_client_secret
# 其他配置选项
```

与 Claude 一起使用

通过将以下内容添加到您的 Claude 配置中，配置 Claude 以使用 MCP 服务器：

{
  "tools": [
    {
      "name": "enhanced-outlook-mcp",
      "url": "http://localhost:3000",
      "auth": {
        "type": "none"
      }
    }
  ]
}

启动 MCP 服务器:
```
npm start
```
在单独的终端中，启动身份验证服务器:
```
npm run auth-server
```
使用 Claude 中的身份验证工具来启动身份验证流程。