JBassist - 微软图 MCP 服务器

一个 Windows 兼容的 MCP 服务器实现，允许 Claude Desktop 通过 Microsoft Graph API 连接到 Microsoft 365 服务。

目录

• 概述
• 标准 API 工具
• Beta API 工具
• 先决条件
• 设置步骤
• 如何运行服务器
• 使用示例
• 故障排除
• 开发信息
• 额外的 Microsoft Graph 端点
• 许可证
• 致谢

概述

这个项目是一个 MCP 服务器，允许 Claude Desktop 通过 Microsoft Graph API 连接到 Microsoft 365 服务。MCP（模型上下文协议）是一种用于在不同系统之间传递信息的协议。

标准 API 工具

此实现包含以下标准 Microsoft Graph API 功能：

• 用户资料信息获取
• 邮件收发
• 日历操作
• 文件存储访问

Beta API 工具

此实现还包含了以下 beta 版本的 Microsoft Graph API 功能：

• 增强的用户个人资料信息
• 组织关系图谱
• 用户状态和存在信息
• 高级搜索功能

先决条件

要使用此 MCP 服务器，您需要以下先决条件：

1. 安装 Node.js 和 npm（版本要求：Node >= 14, npm >= 6）
2. 安装 TypeScript（可选但推荐）
3. 安装 Microsoft 图 Graph 客户端库
4. 创建 Azure AD 应用注册并获取访问令牌

设置步骤

1. 克隆此仓库到本地开发环境中。
2. 在项目根目录下创建一个 .env 文件，填写以下内容：

   TENANT_ID=your_tenant_id
   CLIENT_ID=your_client_id
   CLIENT_SECRET=your_client_secret
   

3. 安装依赖项：运行命令 npm install
4. 启动服务器：运行命令 npm start

如何运行服务器

• 服务器启动后会在控制台输出相关信息，并监听指定端口。
• 可以通过配置文件调整服务器的端口号和日志级别。

使用示例

标准 API 示例

// 获取当前用户资料
GET /api/user-profile

// 发送邮件
POST /api/send-email
{
  "to": "recipient@example.com",
  "subject": "Test Email",
  "body": "This is a test email."
}

Beta API 示例

// 获取增强的用户个人资料
GET /api/beta-user-profile

// 搜索Marketing部门且拥有SQL技能的用户
POST /api/search-users
{
  "department": "Marketing",
  "skills": ["SQL"]
}

故障排除

1. 认证错误：检查 .env 文件中的 Azure AD 应用凭据是否正确。
2. 权限错误：确保您的 Azure AD 应用已获得必要的权限。
3. 连接问题：确认您已点击 Claude Desktop 提示的 MCP 授权按钮。
4. 日志文件：查看 graph-server.log 文件以获取详细错误信息。

开发信息

修改服务器或添加新功能

1. 编辑 src 目录下的文件。
2. 在 src/index.ts 中按照现有模式添加新的工具。
3. 重建项目：运行命令 npm run build
4. 重启服务器。

添加新的 Beta API 功能

1. 参考 Microsoft Graph 的 beta API 文档。
2. 使用 graphBetaClient 实例进行 beta API 调用。
3. 由于 beta API 可能会更改，请进行充分的测试和错误处理。

额外的 Microsoft 图端点

此服务器实现了基本功能，但 Microsoft Graph 提供了更多的端点。例如：

• OneNote 访问
• SharePoint 文档访问
• Teams 消息访问
• OneDrive 文件访问
• 任务管理

请参考 Microsoft Graph 官方文档 获取更多信息。

许可证

MIT

致谢

该项目基于 Windows MCP 天气示例项目，并针对 Microsoft Graph 进行了调整。