🚀 模块化Outlook MCP服务器
这是一个模块化的Outlook MCP（模型上下文协议）服务器的实现，其价值在于借助Microsoft Graph API，成功搭建起Claude与Microsoft Outlook之间的桥梁，实现二者的高效连接。
🚀 快速开始
在Claude Desktop上的使用
- 把
claude-config-sample.json里的示例配置复制到您的Claude Desktop配置中。 - 重启Claude Desktop。
- 运用
authenticate工具开展Microsoft认证。 - 利用电子邮件工具对您的Outlook账户进行管理。
单独运行
若要对服务器进行测试，可使用以下命令：
./test-modular-server.sh
此命令会通过MCP Inspector直接连接到服务器，方便您对可用工具进行测试。
✨ 主要特性
- 认证：采用基于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
📚 详细文档
目录结构
/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 # 测试模式数据
认证流程
- 在3333端口启动本地认证服务器（使用
outlook-auth-server.js）。 - 使用
authenticate工具获取认证URL。 - 在浏览器中完成认证。
- 令牌会存储在
~/.outlook-mcp-tokens.json文件中。
故障排除
- 认证问题：检查令牌文件和认证服务器日志。
- OData过滤错误：查看服务器日志中的转义序列。
- API调用失败：检查响应中的详细错误消息。
扩展服务器
若要添加更多功能，可按以下步骤操作：
- 创建新的模块目录（例如，
calendar/）。 - 在单独的文件中实现工具处理程序。
- 从模块索引文件导出工具定义。
- 导入并将工具添加到
TOOLS数组中的index.js。