模块化Outlook MCP服务器

这是一个模块化的Outlook MCP（模型上下文协议）服务器的实现，用于将Claude与Microsoft Outlook通过Microsoft Graph API连接起来。

目录结构

/modular/
├── index.js                 # 入口文件
├── config.js                # 配置设置
├── auth/                    # 认证模块
│   ├── index.js             # 认证导出
│   ├── token-manager.js     # 令牌存储和刷新
│   └── tools.js             # 认证相关工具
├── email/                   # 电子邮件功能
│   ├── index.js             # 电子邮件导出
│   ├── list.js              # 列出电子邮件
│   ├── search.js            # 搜索电子邮件
│   ├── read.js              # 阅读电子邮件
│   └── send.js              # 发送电子邮件
└── utils/                   # 工具函数
    ├── graph-api.js         # Microsoft Graph API助手
    ├── odata-helpers.js     # OData查询构建
    └── mock-data.js         # 测试模式数据

功能

• 认证: 基于OAuth 2.0的Microsoft Graph API认证
• 电子邮件管理: 列出、搜索、阅读和发送电子邮件
• 模块化结构: 清晰的问题分离，便于维护
• OData过滤处理: OData查询的正确转义和格式化
• 测试模式: 测试时使用模拟响应而无需实际API调用

配置

要配置服务器，请编辑config.js文件以更改：

• 服务器名称和版本
• 测试模式设置
• 认证参数
• 电子邮件字段选择
• API端点

在Claude Desktop上的使用

1. 将claude-config-sample.json中的示例配置复制到您的Claude Desktop配置中
2. 重启Claude Desktop
3. 使用authenticate工具进行Microsoft认证
4. 使用电子邮件工具管理您的Outlook账户

单独运行

要测试服务器，请使用：

./test-modular-server.sh

这将使用MCP Inspector直接连接到服务器，让您测试可用的工具。

认证流程

1. 在3333端口启动本地认证服务器（使用outlook-auth-server.js)
2. 使用authenticate工具获取认证URL
3. 在浏览器中完成认证
4. 令牌存储在~/.outlook-mcp-tokens.json

故障排除

• 认证问题: 检查令牌文件和认证服务器日志
• OData过滤错误: 查看服务器日志中的转义序列
• API调用失败: 检查响应中的详细错误消息

扩展服务器

要添加更多功能：

1. 创建新的模块目录（例如，calendar/)
2. 在单独的文件中实现工具处理程序
3. 从模块索引文件导出工具定义
4. 导入并将工具添加到TOOLS数组中的index.js