
如果你使用 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
描述: Amazon Keyspaces MCP服务器,用于与Keyspaces和Apache Cassandra数据库交互。
由Acuvity打包并发布到我们的精选MCP服务器https://mcp.acuvity.ai,源自awslabs.amazon-keyspaces-mcp-server的原始https://github.com/awslabs/mcp/tree/HEAD/src/amazon-keyspaces-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的策略执行🕵️,并简化编排。
ARC容器包含https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-aws-keyspaces/docker/policy.rego,启用一组运行时https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-aws-keyspaces#️-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基础镜像:
ghcr.io/astral-sh/uv:python3.10-alpine资源:
最新标签:
latest -> 1.0.0-0.0.12 -> 0.0.12使用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-aws-keyspaces: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-aws-keyspaces:0.0.12cosign 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-aws-keyspaces:1.0.0-0.0.12[!TIP] 鉴于mcp-server-aws-keyspaces的操作范围,它可以部署在任何地方。
环境变量与密钥:
DB_USE_KEYSPACES 可选(默认true)DB_KEYSPACES_ENDPOINT 可选(未设置)DB_KEYSPACES_REGION 可选(未设置)DB_CASSANDRA_CONTACT_POINTS 可选(未设置)DB_CASSANDRA_PORT 可选(未设置)DB_CASSANDRA_LOCAL_DATACENTER 可选(未设置)DB_CASSANDRA_USERNAME 必须设置DB_CASSANDRA_PASSWORD 必须设置有关更多信息和额外配置,请参考https://github.com/awslabs/mcp/tree/HEAD/src/amazon-keyspaces-mcp-server。
以下是配置大多数使用MCP提升Copilot体验的客户端的步骤。
[!NOTE] 这些集成在所有Minibridge模式下原生工作。为简洁起见,此处仅涵盖docker本地运行设置。
立即开始,您可以使用以下“一键”链接:
按ctrl + shift + p并输入Preferences: Open User Settings JSON,添加以下部分:
json{ "mcp": { "servers": { "acuvity-mcp-server-aws-keyspaces": { "env": { "DB_CASSANDRA_PASSWORD": "待设置", "DB_CASSANDRA_USERNAME": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "DB_CASSANDRA_USERNAME", "-e", "DB_CASSANDRA_PASSWORD", "docker.io/acuvity/mcp-server-aws-keyspaces:0.0.12" ] } } } }
在您的工作区中创建一个名为.vscode/mcp.json的文件,并添加以下部分:
json{ "servers": { "acuvity-mcp-server-aws-keyspaces": { "env": { "DB_CASSANDRA_PASSWORD": "待设置", "DB_CASSANDRA_USERNAME": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "DB_CASSANDRA_USERNAME", "-e", "DB_CASSANDRA_PASSWORD", "docker.io/acuvity/mcp-server-aws-keyspaces:0.0.12" ] } } }
要传递密钥,您应使用https://code.visualstudio.com/docs/copilot/chat/mcp-servers中描述的`promptString`输入类型。
在~/.codeium/windsurf/mcp_config.json中添加以下部分:
json{ "mcpServers": { "acuvity-mcp-server-aws-keyspaces": { "env": { "DB_CASSANDRA_PASSWORD": "待设置", "DB_CASSANDRA_USERNAME": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "DB_CASSANDRA_USERNAME", "-e", "DB_CASSANDRA_PASSWORD", "docker.io/acuvity/mcp-server-aws-keyspaces:0.0.12" ] } } }
更多信息请参见https://docs.windsurf.com/windsurf/mcp。
将以下JSON块添加到您的mcp配置文件:
~/.cursor/mcp.json.cursor/mcp.jsonjson{ "mcpServers": { "acuvity-mcp-server-aws-keyspaces": { "env": { "DB_CASSANDRA_PASSWORD": "待设置", "DB_CASSANDRA_USERNAME": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "DB_CASSANDRA_USERNAME", "-e", "DB_CASSANDRA_PASSWORD", "docker.io/acuvity/mcp-server-aws-keyspaces:0.0.12" ] } } }
更多信息请参见https://docs.cursor.com/context/model-context-protocol。
在claude_desktop_config.json配置文件中添加以下部分:
json{ "mcpServers": { "acuvity-mcp-server-aws-keyspaces": { "env": { "DB_CASSANDRA_PASSWORD": "待设置", "DB_CASSANDRA_USERNAME": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "DB_CASSANDRA_USERNAME", "-e", "DB_CASSANDRA_PASSWORD", "docker.io/acuvity/mcp-server-aws-keyspaces:0.0.12" ] } } }
更多信息请参见https://docs.anthropic.com/en/docs/agents-and-tools/mcp。
pythonasync with MCPServerStdio( params={ "env": {"DB_CASSANDRA_PASSWORD":"待设置","DB_CASSANDRA_USERNAME":"待设置"}, "command": "docker", "args": ["run","-i","--rm","--read-only","-e","DB_CASSANDRA_USERNAME","-e","DB_CASSANDRA_PASSWORD","docker.io/acuvity/mcp-server-aws-keyspaces:0.0.12"] } ) 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 DB_CASSANDRA_USERNAME -e DB_CASSANDRA_PASSWORD docker.io/acuvity/mcp-server-aws-keyspaces:0.0.12直接运行:
consoledocker run -it -p 8000:8000 --rm --read-only -e DB_CASSANDRA_USERNAME -e DB_CASSANDRA_PASSWORD docker.xuanyuan.run/acuvity/mcp-server-aws-keyspaces:0.0.12
然后在您的应用/客户端中,可配置为:
json{ "mcpServers": { "acuvity-mcp-server-aws-keyspaces": { "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.pem在本地以前端模式启动minibridge:
在您的客户端配置中,Minibridge像任何其他STDIO命令一样工作。例如Claude Desktop:
json{ "mcpServers": { "acuvity-mcp-server-aws-keyspaces": { "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需要一些必填信息才能安装。
必填密钥:
DB_CASSANDRA_USERNAME 密钥需设置为secrets.DB_CASSANDRA_USERNAME,可通过.value或从现有资源的.valueFrom获取。DB_CASSANDRA_PASSWORD 密钥需设置为secrets.DB_CASSANDRA_PASSWORD,可通过.value或从现有资源的.valueFrom获取。可选环境变量:
DB_USE_KEYSPACES="true" 可通过env.DB_USE_KEYSPACES="true"修改。DB_KEYSPACES_ENDPOINT="" 可通过env.DB_KEYSPACES_ENDPOINT=""修改。DB_KEYSPACES_REGION="" 可通过env.DB_KEYSPACES_REGION=""修改。DB_CASSANDRA_CONTACT_POINTS="" 可通过env.DB_CASSANDRA_CONTACT_POINTS=""修改。DB_CASSANDRA_PORT="" 可通过env.DB_CASSANDRA_PORT=""修改。DB_CASSANDRA_LOCAL_DATACENTER="" 可通过env.DB_CASSANDRA_LOCAL_DATACENTER=""修改。您可以查看Chart的README:
consolehelm show readme oci://docker.io/acuvity/mcp-server-aws-keyspaces --version 1.0.0
您可以查看可配置的values:
consolehelm show values oci://docker.io/acuvity/mcp-server-aws-keyspaces --version 1.0.0
使用Helm安装:
consolehelm install mcp-server-aws-keyspaces oci://docker.io/acuvity/mcp-server-aws-keyspaces --version 1.0.0
默认情况下,您的MCP服务器mcp-server-aws-keyspaces可通过集群内部的Kubernetes服务mcp-server-aws-keyspaces在端口8000上通过http/sse访问。您可以通过查看values.yaml文件的service部分进行修改。
部署将创建一个带有healthPort的Kubernetes服务,用于存活探针和就绪探针。此健康端口也可用于您选择的监控堆栈,并在/metrics路径下暴露指标。
有关设置和运行时安全(包括防护措施激活)的更多详细信息,请参见完整的charts https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-aws-keyspaces/charts/mcp-server-aws-keyspaces/README.md。
有关此服务器提供的所有功能、工具、参数和SBOM哈希的详细列表,请参考https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-aws-keyspaces。
💬 有问题?提交issue或联系我们 ***。 📦 欢迎贡献!
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务