关键词

身份管理群组权限企业目录成员资格追踪

项目简介

Grouper MCP 服务器是一个基于 Model Context Protocol 的应用程序后端，专门用于与 Internet2 Grouper 身份管理系统进行交互。它通过标准化的 JSON-RPC 协议向 LLM 客户端提供 Grouper 系统的完整功能访问能力。

主要功能

  • 群组管理：搜索、创建、获取、更新和删除群组
  • 组织架构管理：浏览和搜索文件夹层级结构
  • 成员管理：添加、移除、列出群组成员，追溯成员资格路径
  • 属性管理：为群组分配属性和值
  • 用户管理：搜索、获取用户信息及其群组成员资格
  • 权限追踪：分析用户如何成为群组成员，显示完整的成员资格路径
  • 批量操作：支持批量添加和移除成员，提高操作效率

安装步骤

Docker 安装（推荐）

git clone https://github.com/Unicon/grouper-mcp
cd grouper-mcp
docker build -t grouper-mcp:latest .

HTTP 访问版本

docker build -f Dockerfile.http -t grouper-mcp:http .

服务器配置

在 MCP 客户端（如 Claude Desktop）的配置文件中添加：

{
  "mcpServers": {
    "grouper": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "GROUPER_BASE_URL=https://your-grouper-instance.edu/grouper-ws/servicesRest/json/v4_0_000",
        "-e", "GROUPER_USERNAME=your_username",
        "-e", "GROUPER_PASSWORD=your_password",
        "grouper-mcp:latest"
      ]
    }
  }
}

关键配置参数：

  • 'GROUPER_BASE_URL'：Grouper Web 服务端点 URL
  • 'GROUPER_USERNAME'：Grouper 认证用户名
  • 'GROUPER_PASSWORD": Grouper 认证密码
  • 'READ_ONLY'：设置为 "true" 启用只读模式
  • 'GROUPER_DEBUG'：设置为 "true" 启用详细调试日志

基本使用方法

  1. 配置好环境变量后，MCP 客户端会自动连接到 Grouper 服务器
  2. 使用自然语言指令操作 Grouper 系统，例如：
    • "创建名为 'edu:department:engineering:students' 的群组"
    • "将用户 'jdoe' 添加到 'engineering:students' 群组"
    • "搜索包含 'engineering' 的群组"
  3. 服务器自动记录所有操作日志到 '~/.grouper-mcp/logs/' 目录

信息

分类

商业系统

访问项目