Koppla

基本能力

产品定位

Koppla 是一个专为 Active Directory 设计的 MCP 服务器，旨在通过自然语言简化复杂的目录服务操作。

核心功能

• 自然语言查询：支持使用自然语言执行复杂的 Active Directory 查询，如查找不活跃用户或特定部门的成员。
• 用户和组管理：可以添加或移除用户到组，查询组成员资格等。
• 安全操作：支持有限的写操作（需显式启用），如更新用户属性和管理组成员资格，但对敏感操作有保护措施。
• 加密配置管理：使用 Fernet 加密技术安全存储敏感信息，如 AD 密码。

适用场景

• IT 管理：快速查询和管理 Active Directory 中的用户和组。
• 自动化脚本：与 AI 代理（如 Claude Desktop）集成，自动化常规目录服务任务。
• 安全审计：识别不活跃账户或空组，帮助维护系统安全。

工具列表

• koppla-config：配置管理工具，支持加密存储 AD 凭证和测试连接。
• configure：交互式配置工具。
• show：显示当前配置。
• test：测试 AD 连接。

常见问题解答

• 数据隐私：Koppla 不会存储 AD 数据，但 AI 代理可能保留对话历史，需注意合规性。
• 写操作限制：默认禁用写操作，需手动启用且对敏感账户和组有额外保护。

使用教程

使用依赖

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

安装教程

pip install koppla

调试方式

1. 使用 koppla-config test 测试 AD 连接。
2. 检查环境变量配置是否正确（如 AD_SERVER, AD_USER 等）。
3. 确保 AD_WRITE_ENABLED 设置为 "true" 以启用写操作（如需）。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。