acuvity/mcp-server-aws-dynamodb

mcp-server-aws-dynamodb是什么？

这是用于AWS DynamoDB操作、表管理及备份功能的官方MCP服务器，由Acuvity打包并发布至其MCP服务器注册表，基于awslabs.dynamodb-mcp-server的原始源码构建。

为什么构建此镜像？

Acuvity以安全为核心使命，针对MCP服务器及智能体系统集成的需求，打造了安全可靠的Docker镜像，确保awslabs.dynamodb-mcp-server能够可靠、安全地运行。

🔐 关键安全特性

📦 隔离的不可变沙箱

• 隔离执行：所有工具在安全容器化沙箱内运行，确保进程隔离，防止横向移动。
• 默认非root：遵循最小权限原则，减少潜在安全漏洞的影响。
• 只读文件系统：确保运行时不可变性，防止未授权修改。
• 版本固定：锁定工具及依赖版本，保证部署的一致性和可复现性。
• CVE扫描：通过Docker Scout持续扫描镜像漏洞，支持主动 mitigation。
• SBOM与溯源：嵌入元数据和可追溯的构建信息，提供完整供应链透明度。

🛡️ 运行时安全与防护

通过Minibridge集成实现安全的Agent-to-MCP连接，支持Rego/HTTP-based策略 enforcement，并提供多种运行时防护（guardrails）：

• 隐蔽指令检测：监控请求中的隐藏或混淆指令，防止*** payload。
• 敏感模式检测：阻止敏感数据模式（如.env文件、RSA密钥路径）的泄露。
• 影子模式检测：识别试图覆盖或影响其他工具的***描述。
• ** schema误用预防**：强制遵守MCP输入schema，防止注入或错误。
• 跨源工具访问：控制外部服务调用，仅允许白名单域名。
• 秘密信息脱敏：自动屏蔽日志或响应中的敏感值（如API密钥、JWT）。

🔒 基于共享密钥的基础认证

提供轻量级认证层，客户端需通过Authorization头传递预定义密钥。启用方式：设置BASIC_AUTH_SECRET环境变量。

快速参考

• 维护者：Acuvity团队（打包）、AWSLabs MCP团队（原始源码）
• 支持架构：amd64、arm64
• 基础镜像：ghcr.io/astral-sh/uv:python3.12-alpine
• 验证签名：使用cosign验证镜像签名（参考原始文档）

📦 安装方法

🐳 Docker运行示例

本地HTTP/sse模式

bash
docker run -it -p 8000:8000 --rm --read-only docker.io/acuvity/mcp-server-aws-dynamodb:1.0.2

客户端配置示例：

json
{
  "mcpServers": {
    "acuvity-mcp-server-aws-dynamodb": {
      "url": "http://localhost:8000/sse"
    }
  }
}

启用防护特性

bash
docker run -it -p 8000:8000 --rm --read-only -e GUARDRAILS="secrets-redaction sensitive-pattern-detection" docker.io/acuvity/mcp-server-aws-dynamodb:1.0.2

☁️ Kubernetes部署（Helm）

安装命令：

bash
helm install mcp-server-aws-dynamodb oci://docker.io/acuvity/mcp-server-aws-dynamodb --version 1.0.0

详细配置参考Helm chart文档。

🧰 客户端集成

Visual Studio Code

全局配置（用户设置JSON）：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-aws-dynamodb": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "docker.io/acuvity/mcp-server-aws-dynamodb:1.0.2"
        ]
      }
    }
  }
}

OpenAI Python SDK

本地运行示例：

python
async with MCPServerStdio(
    params={
        "command": "docker",
        "args": ["run","-i","--rm","--read-only","docker.io/acuvity/mcp-server-aws-dynamodb:1.0.2"]
    }
) as server:
    tools = await server.list_tools()

🧠 服务器特性

提供29种工具，支持DynamoDB的各类操作（详细列表参考原始文档）。

💬 问题反馈：通过GitHub issue或联系***
📦 欢迎贡献！ ===END===