
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可:
请先阅读并遵守:https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
https://acuvity.ai
https://acuvity.aihttps://acuvity.ai
https://bsky.app/profile/acuvity.bsky.social
描述: 用于通过LLM工具与Asgardeo组织交互的MCP服务器。
由Acuvity打包并发布至我们的精选MCP服务器https://mcp.acuvity.ai,基于asgardeo/asgardeo-mcp-server原始https://github.com/asgardeo/asgardeo-mcp-server。
快速链接:
| 特性 | 描述 |
|---|---|
| 隔离执行 | 所有工具在安全的容器化沙箱中运行,强制执行进程隔离,防止横向移动。 |
| 默认非root用户 | 遵循最小权限原则,最大限度减少潜在安全漏洞的影响。 |
| 只读文件系统 | 确保运行时不可变性,防止未授权修改。 |
| 版本固定 | 通过锁定工具和依赖版本,保证部署的一致性和可复现性。 |
| CVE扫描 | 使用https://docs.docker.com/scout/持续扫描镜像中的已知漏洞,支持主动缓解。 |
| SBOM与溯源 | 通过嵌入元数据和可追溯的构建信息,提供完整的供应链透明度。 |
| 容器签名(Cosign) | 使用https://github.com/sigstore/cosign实现镜像签名,确保容器镜像的完整性和真实性。 |
Minibridge集成:https://github.com/acuvity/minibridge建立安全的Agent-to-MCP连接,支持Rego/HTTP-based政策执行🕵️,并简化编排。
https://github.com/acuvity/mcp-servers-registry/tree/main容器包含https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-asgardeo/docker/policy.rego,启用一系列运行时https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-asgardeo#️-guardrails,帮助执行服务的安全、隐私和正确使用规范。以下是提供的防护列表:
| 防护 | 摘要 |
|---|---|
resource integrity | 嵌入所有暴露资源的哈希值,确保其真实性,防止未授权修改,抵御供应链***和工具元数据的动态变更。 |
covert-instruction-detection | 检测请求中的隐藏或混淆指令。 |
sensitive-pattern-detection | 标记暗示敏感数据或文件系统暴露的模式。 |
shadowing-pattern-detection | 识别覆盖或影响其他工具描述的工具描述。 |
schema-misuse-prevention | 对输入数据强制执行严格的 schema 合规性。 |
cross-origin-tool-access | 控制对外部服务或API的调用。 |
secrets-redaction | 防止凭据或敏感值暴露。 |
basic authentication | 允许配置共享密钥,限制对MCP服务器的未授权访问,确保只有经批准的客户端可以连接。 |
这些控制确保了强大的运行时完整性,防止未授权行为,并为安全设计的系统操作提供基础。
[!NOTE] 默认情况下,除
resource integrity外的所有防护均处于关闭状态。您可以单独启用或禁用每个防护,确保仅激活您环境所需的保护。
维护者:
获取帮助:
提交问题:
支持的架构:
amd64arm64基础镜像:
alpine:3.21资源:
最新标签:
latest -> 1.0.0-v0.2.0 -> v0.2.0使用https://github.com/sigstore/cosign验证签名:
cosign verify --certificate-oidc-issuer "https://token.actions.githubusercontent.com" --certificate-identity "https://github.com/acuvity/mcp-servers-registry/.github/workflows/release.yaml@refs/heads/main" docker.io/acuvity/mcp-server-asgardeo:latestcosign verify --certificate-oidc-issuer "https://token.actions.githubusercontent.com" --certificate-identity "https://github.com/acuvity/mcp-servers-registry/.github/workflows/release.yaml@refs/heads/main" docker.io/acuvity/mcp-server-asgardeo:v0.2.0cosign verify --certificate-oidc-issuer "https://token.actions.githubusercontent.com" --certificate-identity "https://github.com/acuvity/mcp-servers-registry/.github/workflows/release.yaml@refs/heads/main" docker.io/acuvity/mcp-server-asgardeo:1.0.0-v0.2.0[!TIP] 鉴于mcp-server-asgardeo的操作范围,它可以部署在任何地方。
环境变量与密钥:
ASGARDEO_BASE_URL 必须设置ASGARDEO_CLIENT_ID 必须设置ASGARDEO_CLIENT_SECRET 必须设置更多信息和额外配置,请参考https://github.com/asgardeo/asgardeo-mcp-server。
以下是配置大多数使用MCP提升Copilot体验的客户端的步骤。
[!NOTE] 这些集成在所有Minibridge模式下原生工作。为简洁起见,此处仅涵盖Docker本地运行设置。
立即开始,您可以使用以下“一键”链接:
按下 ctrl + shift + p 并输入 Preferences: Open User Settings JSON,添加以下部分:
json{ "mcp": { "servers": { "acuvity-mcp-server-asgardeo": { "env": { "ASGARDEO_BASE_URL": "待设置", "ASGARDEO_CLIENT_ID": "待设置", "ASGARDEO_CLIENT_SECRET": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "ASGARDEO_BASE_URL", "-e", "ASGARDEO_CLIENT_ID", "-e", "ASGARDEO_CLIENT_SECRET", "docker.io/acuvity/mcp-server-asgardeo:v0.2.0" ] } } } }
在您的工作区中创建一个名为 .vscode/mcp.json 的文件,并添加以下部分:
json{ "servers": { "acuvity-mcp-server-asgardeo": { "env": { "ASGARDEO_BASE_URL": "待设置", "ASGARDEO_CLIENT_ID": "待设置", "ASGARDEO_CLIENT_SECRET": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "ASGARDEO_BASE_URL", "-e", "ASGARDEO_CLIENT_ID", "-e", "ASGARDEO_CLIENT_SECRET", "docker.io/acuvity/mcp-server-asgardeo:v0.2.0" ] } } }
要传递密钥,您应使用https://code.visualstudio.com/docs/copilot/chat/mcp-servers中描述的
promptString输入类型。
在 ~/.codeium/windsurf/mcp_config.json 中添加以下部分:
json{ "mcpServers": { "acuvity-mcp-server-asgardeo": { "env": { "ASGARDEO_BASE_URL": "待设置", "ASGARDEO_CLIENT_ID": "待设置", "ASGARDEO_CLIENT_SECRET": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "ASGARDEO_BASE_URL", "-e", "ASGARDEO_CLIENT_ID", "-e", "ASGARDEO_CLIENT_SECRET", "docker.io/acuvity/mcp-server-asgardeo:v0.2.0" ] } } }
更多信息请参见https://docs.windsurf.com/windsurf/mcp。
将以下JSON块添加到您的mcp配置文件:
~/.cursor/mcp.json.cursor/mcp.jsonjson{ "mcpServers": { "acuvity-mcp-server-asgardeo": { "env": { "ASGARDEO_BASE_URL": "待设置", "ASGARDEO_CLIENT_ID": "待设置", "ASGARDEO_CLIENT_SECRET": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "ASGARDEO_BASE_URL", "-e", "ASGARDEO_CLIENT_ID", "-e", "ASGARDEO_CLIENT_SECRET", "docker.io/acuvity/mcp-server-asgardeo:v0.2.0" ] } } }
更多信息请参见https://docs.cursor.com/context/model-context-protocol。
在 claude_desktop_config.json 配置文件中添加以下部分:
json{ "mcpServers": { "acuvity-mcp-server-asgardeo": { "env": { "ASGARDEO_BASE_URL": "待设置", "ASGARDEO_CLIENT_ID": "待设置", "ASGARDEO_CLIENT_SECRET": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "ASGARDEO_BASE_URL", "-e", "ASGARDEO_CLIENT_ID", "-e", "ASGARDEO_CLIENT_SECRET", "docker.io/acuvity/mcp-server-asgardeo:v0.2.0" ] } } }
更多信息请参见https://docs.anthropic.com/en/docs/agents-and-tools/mcp。
pythonasync with MCPServerStdio( params={ "env": {"ASGARDEO_BASE_URL":"待设置","ASGARDEO_CLIENT_ID":"待设置","ASGARDEO_CLIENT_SECRET":"待设置"}, "command": "docker", "args": ["run","-i","--rm","--read-only","-e","ASGARDEO_BASE_URL","-e","ASGARDEO_CLIENT_ID","-e","ASGARDEO_CLIENT_SECRET","docker.io/acuvity/mcp-server-asgardeo:v0.2.0"] } ) as server: tools = await server.list_tools()
pythonasync with MCPServerSse( params={ "url": "http://<ip>:<port>/sse", } ) as server: tools = await server.list_tools()
更多信息请参见https://openai.github.io/openai-agents-python/mcp/。
在您的客户端配置中设置:
dockerrun -i --rm --read-only -e ASGARDEO_BASE_URL -e ASGARDEO_CLIENT_ID -e ASGARDEO_CLIENT_SECRET docker.io/acuvity/mcp-server-asgardeo:v0.2.0直接运行:
consoledocker run -it -p 8000:8000 --rm --read-only -e ASGARDEO_BASE_URL -e ASGARDEO_CLIENT_ID -e ASGARDEO_CLIENT_SECRET docker.xuanyuan.run/acuvity/mcp-server-asgardeo:v0.2.0
然后在您的应用/客户端中,可配置为:
json{ "mcpServers": { "acuvity-mcp-server-asgardeo": { "url": "http://localhost:8000/sse" } } }
您可能需要为不同工具使用不同端口。
本节假设您熟悉TLS和证书,需要:
- 包含与工具部署匹配的正确DNS/IP字段的服务器证书。
- 用于签署客户端证书的client-ca。
backend模式启动服务器-e MINIBRIDGE_MODE=backend-v $PWD/certs:/certs)添加TLS证书(推荐)-e MINIBRIDGE_TLS_SERVER_CERT=/certs/server-cert.pem-e MINIBRIDGE_TLS_SERVER_KEY=/certs/server-key.pem-e MINIBRIDGE_TLS_SERVER_KEY_PASS=可选-e MINIBRIDGE_TLS_SERVER_CLIENT_CA=/certs/client-ca.pemminibridge:在您的客户端配置中,Minibridge像任何其他STDIO命令一样工作。
Claude Desktop示例:
json{ "mcpServers": { "acuvity-mcp-server-asgardeo": { "command": "minibridge", "args": ["frontend", "--backend", "wss://<remote-url>:8000/ws", "--tls-client-backend-ca", "/path/to/ca/that/signed/the/server-cert.pem/ca.pem", "--tls-client-cert", "/path/to/client-cert.pem", "--tls-client-key", "/path/to/client-key.pem"] } } }
就是这样。
Minibridge提供了许多额外功能。如需分步指南,请访问wiki。如有任何不清楚的地方,请随时联系我们!
此Chart需要一些必填信息才能安装。
必填密钥:
ASGARDEO_CLIENT_ID 密钥需设置为secrets.ASGARDEO_CLIENT_ID,可通过.value或现有.valueFrom设置。ASGARDEO_CLIENT_SECRET 密钥需设置为secrets.ASGARDEO_CLIENT_SECRET,可通过.value或现有.valueFrom设置。必填环境变量:
ASGARDEO_BASE_URL 环境变量需通过env.ASGARDEO_BASE_URL设置。您可以查看Chart的README:
consolehelm show readme oci://docker.io/acuvity/mcp-server-asgardeo --version 1.0.0
您可以查看可配置的values:
consolehelm show values oci://docker.io/acuvity/mcp-server-asgardeo --version 1.0.0
使用Helm安装:
consolehelm install mcp-server-asgardeo oci://docker.io/acuvity/mcp-server-asgardeo --version 1.0.0
此后,您的MCP服务器mcp-server-asgardeo默认可通过集群内部的Kubernetes Service mcp-server-asgardeo在端口8000上通过http/sse访问。您可以通过查看values.yaml文件的service部分进行更改。
部署将创建一个带有healthPort的Kubernetes服务,用于存活探针和就绪探针。此健康端口也可用于您选择的监控堆栈,并在/metrics路径下暴露指标。
有关设置和运行时安全(包括防护激活)的更多详细信息,请参见完整的charts https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-asgardeo/charts/mcp-server-asgardeo/README.md。
有关此服务器提供的所有功能、工具、参数和SBOM哈希的详细列表,请参见https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-asgardeo
💬 有问题?提交issue或联系我们 ***。 📦 欢迎贡献!
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务