Asgardeo MCP Server

Asgardeo MCP 服务

Asgardeo MCP 服务可让你使用大模型工具无缝管理 Asgardeo 组织或 WSO2 Identity Server 部署，并通过自然语言交互完成各种配置任务。

重要

实验性功能说明
此软件包含实验性功能，不适用于生产环境。 随着实现不断演进，功能、API 和特性可能会随时更改，恕不另行通知。

主要用例

使用 Claude Desktop 等工具，你可以：

• 列出应用程序：获取组织中所有应用程序的列表。
• 创建应用程序：设置单页应用、Web 应用、移动应用或 M2M 应用，并将其与 Asgardeo 身份验证 SDK 集成。
• 获取应用程序详情：获取特定应用程序的详细信息。
• 配置登录流程：使用自然语言提示词和可用工具自定义应用程序的登录流程，从而提供无缝的用户身份验证体验。

演示

• 在 Claude 中列出应用程序
  

• 在 Claude 中获取应用程序详情
  

---

使用方法

在 Asgardeo / WSO2 Identity Server 上

1. 创建 M2M 应用程序：在组织中设置一个 M2M 应用程序。
2. 授权管理 API：向应用程序授予以下范围：

API	范围
Application Management API (/api/server/v1/applications)	internal_application_mgt_view, internal_application_mgt_update, internal_application_mgt_create
API Resource Management API (/api/server/v1/api-resources)	internal_api_resource_create, internal_api_resource_view
Identity Provider Management API (/api/server/v1/identity-providers)	internal_idp_view
Authenticators Management API (/api/server/v1/authenticators)	internal_authenticator_view
Claim Management API (/api/server/v1/claim-dialects)	internal_claim_meta_view
SCIM2 Users API (/scim2/Users)	internal_user_mgt_create
OIDC Scope Management API (/api/server/v1/oidc/scopes)	internal_oidc_scope_mgt_view

3. 复制凭据：保存 M2M 应用程序的客户端 ID 和客户端密钥。

在你的计算机上

4. 克隆代码库：

git clone https://github.com/asgardeo/asgardeo-mcp-server.git

5. 安装依赖项：

go mod tidy

6. 构建可执行文件：

go build -o asgardeo-mcp

这将在当前目录中创建 asgardeo-mcp 二进制文件（例如，/Users/<user directory>/asgardeo-mcp-server/asgardeo-mcp）。记下此绝对路径，因为你将在下一步中用到它。

7. 配置 MCP 客户端：

VS Code（GitHub Copilot）

• 安装 GitHub Copilot 扩展。
• 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），然后选择 MCP: Open User Configuration。
• 将以下服务配置添加到 mcp.json 文件中：

  {
    "servers": {
        "asgardeo-mcp-server": {
            "type": "stdio",
            "command": "<absolute path to the asgardeo-mcp executable>",
            "args": [],
            "env": {
                "BASE_URL" : "https://api.asgardeo.io/t/<asgardeo organization>",
                "CLIENT_ID" : "<client ID>",
                "CLIENT_SECRET" : "<client secret>"
              }
            }
    }
  }
  

• 保存文件，并从 mcp.json 启动 MCP 服务。

Claude Desktop

• 打开 Claude Desktop，然后转到 Settings > Developer。
• 编辑 claude_desktop_config.json 文件：

  "asgardeo-mcp": {
   "command": "<absolute path to the asgardeo-mcp executable>",
   "args": [],
   "env": {
    "BASE_URL": "https://api.asgardeo.io/t/<asgardeo organization>",
    "CLIENT_ID": "<client ID>",
    "CLIENT_SECRET": "<client secret>"
   }
  }
  

• 重启 Claude Desktop。

Cursor

• 打开 Cursor，然后转到 Settings > MCP。
• 编辑 mcp.json 文件：

  "asgardeo-mcp": {
   "command": "<absolute path to the asgardeo-mcp executable>",
   "args": [],
   "env": {
    "BASE_URL": "https://api.asgardeo.io/t/<asgardeo organization>",
    "CLIENT_ID": "<client ID>",
    "CLIENT_SECRET": "<client secret>"
   }
  }
  

说明

• 如果你使用的是 WSO2 Identity Server，则需要设置一个额外的环境变量 PRODUCT_MODE，并将其值设为 wso2is。
• 此外，请将 BASE_URL 替换为你的 WSO2 Identity Server 基础 URL（例如，https://<your-wso2is-host>/t/<tenant-domain>）。
• 另外，如果你在本地开发或内部网络中使用 WSO2 Identity Server，可能需要为服务设置证书颁发机构（CA），以避免 SSL 错误。你可以将 CERT_PATH 环境变量设为 CA 证书文件的路径来完成此操作。

---

可用工具

Asgardeo MCP 服务提供以下工具，用于与您的组织交互：

应用管理

工具名称	描述	参数
list_applications	列出您组织中的所有应用	无
create_single_page_app	创建新的单页应用	application_name（必填）：应用名称 redirect_url（必填）：应用的重定向 URL
create_webapp_with_ssr	创建支持服务器端渲染的新 Web 应用	application_name（必填）：应用名称 redirect_url（必填）：应用的重定向 URL
create_mobile_app	创建新的移动应用	application_name（必填）：应用名称 redirect_url（必填）：应用的重定向 URL
create_m2m_app	创建新的机器对机器应用	application_name（必填）：应用名称
get_application_by_name	按名称获取应用详情	application_name（必填）：要搜索的应用名称
get_application_by_client_id	按客户端 ID 获取应用详情	client_id（必填）：应用的客户端 ID
update_application_basic_info	更新应用的基本信息	id（必填）：应用的 ID name、description、image_url、access_url、logout_return_url（可选）
update_application_oauth_config	更新应用的 OAuth/OIDC 配置	id（必填）：应用的 ID redirect_urls、allowed_origins、user_access_token_expiry_time、application_access_token_expiry_time、refresh_token_expiry_time 等（可选）
update_application_claim_config	更新应用的声明配置	id（必填）：应用的 ID claims（必填）：请求的声明 URI 列表（声明 URI 应使用默认的 WSO2 声明方言指定。例如：http://wso2.org/claims/username）
authorize_api	授权应用访问 API	appId（必填）：应用的 ID id（必填）：API 资源的 ID policyIdentifier（必填，默认值："RBAC"）：授权策略 scopes（必填）：要授权的范围
list_authorized_api	列出应用已获授权的 API 资源	app_id（必填）：应用的 ID
update_login_flow	根据自然语言提示词更新应用中的登录流程	app_id（必填）：应用的 ID user_prompt（必填）：对所需登录流程的自然语言描述

API 资源管理

工具名称	描述	参数
list_api_resources	列出您组织中的 API 资源	filter（可选）：筛选表达式 limit（可选）：要返回的最大结果数
search_api_resources_by_name	按名称搜索 API 资源	name（必填）：要搜索的 API 资源名称
get_api_resource_by_identifier	根据标识符获取 API 资源	identifier（必填）：API 资源的标识符
create_api_resource	创建新的 API 资源	identifier（必填）：API 资源的标识符 name（必填）：API 资源的名称 requiresAuthorization（必填）：API 是否需要授权 scopes（必填）：API 的范围列表

用户管理

工具名称	描述	参数
create_user	在您的组织中创建用户	username（必填）：用户名 password（必填）：密码 email（必填）：电子邮件地址 first_name（必填）：用户的名字 last_name（必填）：用户的姓氏 userstore_domain（可选，默认值："DEFAULT"）：用户存储域

声明管理

工具名称	描述	参数
list_claims	列出组织中的声明	无

说明

如果您使用的是 WSO2 Identity Server，并计划使用 update_login_flow 工具，请务必按照订阅 AI 功能中的步骤操作。

---

示例提示词

应用管理

• 创建 SPA：

  Create a new Single Page Application named "My Demo App" with redirect URL "https://example.com/callback".
  

• 更新应用：

  Update my application with ID "abc123" to have a new name "Updated App".
  

• 更新应用登录流程：

  Update the login flow of my application with ID "abc123" to Username and Password as the first step and Email OTP as the second step.
  

• 更新应用声明配置：

  Update the claim configuration of my application with ID "abc123" to include "username", and "last_name".
  

API 资源管理

• 创建并授权 API：

  Create a new API resource named "Customer API" and authorize my application to access it with "read:customers" scopes.
  

用户管理

• 创建用户：

  Create a test user with the username and email address '[email protected]'.
  

声明管理

• 获取声明列表：

  List all claims in my Asgardeo organization.
  

---

故障排除

身份验证与权限

• 凭据无效：检查基本 URL 中的客户端 ID、客户端密钥和组织名称
• 403 Forbidden：检查您的 M2M 应用是否已获授权使用所有必需的范围

设置与连接

• 构建问题：确保已安装 Go 1.18+，并在构建前运行 go mod tidy
• MCP 连接：确认可执行文件路径为正确的绝对路径，并检查权限（chmod +x asgardeo-mcp）

获取帮助

如果排查后问题仍然存在：

• 查看 GitHub issues
• 创建新的详细问题报告，并附上错误消息和环境信息
• 加入 WSO2 社区论坛以获取支持

---

贡献

欢迎贡献！请通过 GitHub 仓库提交问题或拉取请求。