🚀 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
这个交互式工具会执行以下操作：
- 提示您输入 Active Directory 连接的详细信息。
- 利用 Fernet 对称加密技术，安全地加密您的密码。
- 在 Claude Desktop 配置文件中创建或更新 Koppla 服务器设置。
- 自动备份现有的 Claude Desktop 配置。
- 测试连接以验证凭证的有效性。
您还可以使用以下命令：
- 显示当前配置：
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 的用户。”
⚠️ 重要提示
所有写入操作都需要明确确认后才会执行。