7160 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权限 → 添加权限 → 微软图形 → 应用程序权限

1. 添加这些权限：

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

______________________________________________________________________

💻 在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服务器 框架