微软图形快速MCP服务器

EntraID MCP Server 是一个模块化、面向资源的FastMCP服务器,用于与Microsoft Graph API交互。它设计用于扩展性、可维护性和安全性,支持高级查询用户、登录日志、MFA状态和特权用户。

  • by hieuttmmo
  • 更新于
在 GitHub 查看 hieuttmmo/entraid-mcp-server

使用说明

基本能力

产品定位

EntraID MCP Server 是一个模块化、面向资源的FastMCP服务器,用于与Microsoft Graph API交互。

核心功能

  • 模块化资源结构:每个资源(用户、登录日志、MFA等)都在自己的模块中实现。
  • 集中式Graph客户端:处理认证和客户端初始化。
  • 全面的用户操作:按名称/电子邮件搜索用户,按ID获取用户,列出所有特权用户。
  • 完整的组生命周期和成员管理:创建、读取、更新和删除组,添加/删除组成员和所有者。
  • 应用程序和服务主体管理:列出、创建、更新和删除应用程序和服务主体。
  • 登录日志操作:查询用户最近X天的登录日志。
  • MFA操作:获取用户的MFA状态。
  • 密码管理:重置用户密码。
  • 权限助手:建议适当的Microsoft Graph权限。
  • 错误处理和日志记录:一致的错误处理和进度报告。
  • 安全性:使用Microsoft最佳实践进行认证。

适用场景

  • 企业用户管理
  • 安全审计和监控
  • 组和应用程序管理
  • 密码重置和MFA状态检查

使用教程

1. 安装依赖

fastmcp install /path/to/src/msgraph_mcp_server/server.py --with msgraph-sdk --with azure-identity --with azure-core --with msgraph-core -f /path/to/.env

2. 安装步骤

  1. 克隆仓库。
  2. 创建config/.env文件,包含Azure AD凭证:
TENANT_ID=your-tenant-id
CLIENT_ID=your-client-id
CLIENT_SECRET=your-client-secret
  1. 如果需要,设置基于证书的认证。

3. 调试方式

fastmcp dev /path/to/src/msgraph_mcp_server/server.py