Entraid MCP Server

🚀 EntraID MCP サーバー

EntraID MCP サーバーは、Python をベースとしたツールで、Microsoft Graph API を通じて Azure AD と Microsoft Entra の認証環境を詳細に分析します。このサーバーは、ディレクトリアクセス、グループ管理、ポリシー読み取り、ロール管理、ユーザーパスワードリセットなど、さまざまな機能を提供します。

🚀 クイックスタート

EntraID MCP サーバーを使用するには、まず環境変数を設定し、サーバーを起動する必要があります。詳細な手順は以下の通りです。

環境変数の設定

.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

💻 使用例

基本的な使用法

ユーザー管理

ユーザーの一覧表示

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/：ユーザー管理、グループ管理などの具体的な機能モジュールが含まれています。

機能モジュール

ユーザー管理

• ユーザーの一覧表示：すべてのユーザーを取得することができます。
• パスワードのリセット：指定したユーザーのパスワードをリセットすることができます。

監査ログ

• 監査ログの取得：指定したユーザーの監査ログを取得することができます。

🔧 技術詳細

権限要件

以下に、すべての必須の Microsoft Graph 権限とその機能を示します。

拡張機能の追加

新しい機能モジュールを追加するには、以下の手順に従ってください。

1. tools/ フォルダーに新しい Python クラスを作成します。
2. @mcp.tool() デコレータを使用して新しいツールを登録します。
3. server.py で新しいツールをインポートして登録します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。