Microsoft Graph MCP服务器

微软图形mcp

🚀 Microsoft Graph MCP Server

用于AI助手的Microsoft 365集成 -将Cursor、Claude Desktop和其他MCP兼容工具直接连接到Microsoft Graph。访问Outlook、OneDrive、日历、团队，并使用AI自动化工作流程。

✅ 我们提供什么（这个项目）

📊 Microsoft图形概述

Microsoft Graph跨Microsoft 365服务（团队、日历、文件、邮件、人员、任务等）连接用户、他们的活动和内容。此MCP服务器为AI助手提供了直接访问此统一数据层的权限。

🚀 快速开始

安装方法

使用npx运行（推荐）

AZURE_CLIENT_ID=your-client-id \
AZURE_CLIENT_SECRET=your-client-secret \
AZURE_TENANT_ID=your-tenant-id \
npx microsoft-graph-mcp

就是这样！ 服务器运行在：

使用.env文件运行

创建一个 .env 文件：

AZURE_CLIENT_ID=your-client-id
AZURE_CLIENT_SECRET=your-client-secret
AZURE_TENANT_ID=your-tenant-id

然后运行：

npx microsoft-graph-mcp

📋 Azure配置

配置步骤概述

步骤1：创建Azure应用程序注册

1. 首选 Azure门户
2. 导航至 Azure Active Directory > 应用程序注册
3. 点击 新注册
4. 填写：
   • 名字：Microsoft Graph MCP服务器
   • 支持的帐户类型：仅此组织目录中的帐户（或多租户）
   • 点击 注册

步骤2：获取凭据

1. 应用程序（客户端）ID → 将此复制为 AZURE_CLIENT_ID
2. 目录（租户）ID → 将此复制为 AZURE_TENANT_ID
3. 首选 证书和秘密 → 新客户机密
   • 复制 机密值 作为 AZURE_CLIENT_SECRET （只显示一次！）

步骤3：添加应用程序权限

1. 首选 API权限 → 添加权限 → 微软图形 → 应用程序权限

2. 添加这些权限：

   权限	类型	描述
   User.Read.All	应用程序	读取所有用户
   Mail.Read	应用程序	读取所有邮箱中的邮件
   Mail.Send	应用程序	以任何用户身份发送邮件
   Calendars.Read	应用程序	读取所有邮箱中的日历
   Files.Read.All	应用程序	读取所有文件
   Group.Read.All	应用程序	读取所有组
   Contacts.Read	应用程序	读取联系人
   Tasks.ReadWrite.All	应用程序	读写任务
   Organization.Read.All	应用程序	读取组织信息
   People.Read.All	应用程序	读取人员配置文件
   Application.Read.All	应用程序	读取应用程序
   Subscription.Read.All	应用程序	管理订阅

3. ⚠️ 关键： 点击 授予[您的组织]管理员同意

💻 在Cursor/Claude桌面中使用

MCP客户端配置概述

配置步骤

对于光标

1. 打开 光标设置 → 特性 → 模型上下文协议
2. 点击 “编辑配置”
3. 添加以下配置
4. 保存并重新启动游标

适用于克劳德桌面

1. 找到并打开配置文件（见上表）
2. 添加以下配置
3. 保存文件
4. 重新启动克劳德桌面

配置JSON（所有客户端）

{
  "mcpServers": {
    "microsoft-graph-mcp": {
      "command": "npx",
      "args": ["-y", "microsoft-graph-mcp"],
      "env": {
        "AZURE_CLIENT_ID": "your-client-id",
        "AZURE_CLIENT_SECRET": "your-client-secret",
        "AZURE_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

注： 替换 your-client-id, your-client-secret，以及 your-tenant-id 使用您的实际Azure凭据。

📡 使用REST API

服务器运行后，您可以通过REST端点完全访问Microsoft Graph。

🔍 交互式API文档

Swagger用户界面 （推荐-视觉界面）：

http://localhost:8887/docs

• 浏览所有端点
• 直接在浏览器中尝试请求
• 请参阅请求/响应模式

OpenAPI JSON:

http://localhost:8887/openapi.json

• 导入Postman、Insomnia或任何与OpenAPI兼容的工具

📝 常见API示例

详细示例

发送电子邮件：

curl -X POST http://localhost:8887/graph/mail \
  -H "Content-Type: application/json" \
  -d '{
    "toRecipients": [{"emailAddress": {"address": "user@example.com"}}],
    "subject": "Hello from microsoft-graph-mcp!",
    "body": {"contentType": "text", "content": "This is a test message"}
  }'

创建日历事件：

curl -X POST http://localhost:8887/graph/calendar/events \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Team Meeting",
    "start": {"dateTime": "2024-01-15T10:00:00", "timeZone": "UTC"},
    "end": {"dateTime": "2024-01-15T11:00:00", "timeZone": "UTC"},
    "userId": "user@domain.com"
  }'

📚 所有可用端点

用户（6个端点）

邮件（7个端点）

日历（5个端点）

文件/OneDrive（4个端点）

组（3个端点）

团队（2个端点）

联系人（2个端点）

任务（2个端点）

附加服务

系统

所有端点都会自动作为MCP工具公开，供AI代理使用。

⚙️ 高级配置

环境变量

🎯 用例

按用户类型

按界面

🔧 故障排除

📖 了解更多

文档和资源

📦 包信息

🆘 需要帮助？

快速诊断检查表

🛠️ 发展

此MCP服务器是使用 简易mcp服务器 框架。

发展资料

地方发展设置

1. 克隆 | git clone https://github.com/easynet-world/7160-microsoft-graph-mcp.git |获取源代码
2. 安装 | npm install |安装依赖项
3. 配置 |复制 .env.example 到 .env |设置环境变量
4. 构建 | npm run build |编译TypeScript
5. 测试 | npm test |运行测试套件
6. 开始 | npm start |启动开发服务器

由...驱动 简易mcp服务器 框架