JinDaGe - outlook-mcp MCP Details

article

README

🚀 模块化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。

outlook-mcp