Entraid MCP Server

🚀 EntraID MCP 服務器

EntraID MCP 服務器是一款基於 Python 的實用工具，藉助 Microsoft Graph API 對 Azure AD 和 Microsoft Entra 身份驗證環境展開深度剖析。它提供了豐富多樣的功能，涵蓋目錄訪問、組管理、策略讀取、角色管理以及用戶密碼重置等，助力用戶高效管理身份驗證環境。

🚀 快速開始

環境變量配置

創建一個 .env 文件，並添加以下內容：

TENANT_ID=your_tenant_id
CLIENT_ID=your_client_id
CLIENT_SECRET=your_client_secret

基本用法

在終端中運行以下命令以啟動服務器：

python -m server

✨ 主要特性

• 全面的目錄訪問：能夠讀取所有用戶的完整配置文件。
• 組和成員管理：支持讀取所有組及其成員關係。
• 策略讀取：可以查看組織中的所有策略信息。
• 角色管理：具備讀取目錄基於角色的訪問控制（RBAC）設置的能力。
• 用戶身份驗證方法：能夠讀取所有用戶的認證方式。
• 審計日誌：支持查閱所有的審核日誌數據。
• 安全措施：採用最小權限原則，僅授予必要的 Microsoft Graph 權限。

📦 安裝指南

環境變量配置

創建一個 .env 文件，並添加以下內容：

TENANT_ID=your_tenant_id
CLIENT_ID=your_client_id
CLIENT_SECRET=your_client_secret

啟動服務器

在終端中運行以下命令以啟動服務器：

python -m server

💻 使用示例

基礎用法

用戶管理

用戶查詢

from user_management import UserManagementTool

tool = UserManagementTool()
users = tool.list_all_users()
print(users)

密碼重置

from user_management import reset_password

result = reset_user_password_direct(user_id="12345", require_change=True, generate_password=True)
print(result)

審核日誌

日誌查詢

from audit_logs import get_audit_logs

logs = get_user_audit_logs(user_id="67890", days=30)
print(logs)

📚 詳細文檔

項目結構

• environ.py：包含環境變量和配置信息。
• server.py：主服務器文件，負責處理各種請求。
• tools/：包含具體的功能模塊，如用戶管理、組管理等。

功能模塊

用戶管理

用戶查詢

from user_management import UserManagementTool

tool = UserManagementTool()
users = tool.list_all_users()
print(users)

密碼重置

from user_management import reset_password

result = reset_user_password_direct(user_id="12345", require_change=True, generate_password=True)
print(result)

審核日誌

日誌查詢

from audit_logs import get_audit_logs

logs = get_user_audit_logs(user_id="67890", days=30)
print(logs)

權限要求

以下列出所有必需的 Microsoft Graph 權限及其作用：

擴展說明

若要添加新功能模塊，請按照以下步驟操作：

1. 在 tools/ 文件夾下創建新的 Python 類。
2. 使用 @mcp.tool() 裝飾器註冊新的工具。
3. 在 server.py 中導入並註冊新工具。

安全注意事項

• 避免提交敏感信息：確保 .env 和其他敏感文件不會被納入版本控制系統。
• 最小權限原則：僅授予必要的 Microsoft Graph 權限以減少潛在風險。
• 審計與監控：利用日誌輸出進行故障排除和監控。

📄 許可證

MIT License