Koppla-Active-Directory

🚀 Koppla

Koppla 是一个模型上下文协议服务器，专为 Active Directory 设计。它允许用户通过自然语言对用户、组和计算机对象进行管理，极大地提升了管理效率。

了解更多，请访问 https://lazyadmin.nl/koppla

借助 Koppla，您能够轻松利用 Claude Desktop 或其他支持 MCP 的人工智能代理，对 Active Directory 环境进行查询和管理。

🚀 快速开始

🔍 先决条件

• Python 3.7 或更高版本
• Active Directory 环境
• Claude Desktop 应用程序（用于与 Claude 集成）

📦 安装指南

Koppla 需要 Python 环境，可通过以下命令进行安装：

pip install koppla

⚙️ 配置说明

使用配置管理器（推荐）

Koppla 自带一个安全的配置管理器，可对敏感凭证进行加密处理：

koppla-config configure

这个交互式工具会执行以下操作：

1. 提示您输入 Active Directory 连接的详细信息。
2. 利用 Fernet 对称加密技术，安全地加密您的密码。
3. 在 Claude Desktop 配置文件中创建或更新 Koppla 服务器设置。
4. 自动备份现有的 Claude Desktop 配置。
5. 测试连接以验证凭证的有效性。

您还可以使用以下命令：

• 显示当前配置：koppla-config show
• 测试您的 AD 连接：koppla-config test

手动配置

Koppla 支持使用环境变量进行配置，具体如下： | 属性 | 详情 | |------|------| | AD_SERVER | Active Directory 服务器地址。 | | AD_USER | 身份验证用户名。 | | AD_PASSWORD | 用于身份验证的密码。 | | BASE_DN | LDAP 查询的基础 DN。 | | AD_WRITE_ENABLED | 启用或禁用写入操作（true/false）。 |

若要手动配置 Koppla 与 Claude Desktop 的集成，请运行以下命令：

koppla-config init

运行该命令后，系统会提示您输入必要的信息，并生成配置文件。

✨ 主要特性

Koppla 支持执行复杂的 Active Directory 查询和更新，例如：

• “查找 90 天内未登录的 inactive 用户。”
• “将 John Doe 添加到 'IT Admins' 安全组。”
• “列出所有锁定的用户账户。”
• “查找销售部门的所有用户。”
• “Jane Smith 属于哪些组？”
• “显示空闲组。”
• “查找属于组 A 但不属于组 B 的用户。”

⚠️ 重要提示

所有写入操作都需要明确确认后才会执行。