Jbassist

🚀 JBassist - 微软图 MCP 服务器

JBassist 是一个兼容 Windows 的 MCP 服务器实现，它允许 Claude Desktop 通过 Microsoft Graph API 连接到 Microsoft 365 服务，为系统间的信息传递提供了便利。

🚀 快速开始

JBassist 是一个 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. 编辑 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 进行了调整。

故障排除

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