DynamoDB 扫描仪

⚠️重要通知

• DynamoDB 扫描操作会扫描整个表，这可能会产生大量成本。

• 最大结果大小限制为 1MB，因此您可能需要使用分页来检索所有所需数据。

• 建议仅将此工具用于测试目的。

• 对于生产来说，实现适合您的数据访问模式的查询操作会更有效率。

• 扫描大型数据集时，请注意 DynamoDB 读取容量 (RCU) 的消耗。

DynamoDB Scanner 是一款用于扫描和筛选 AWS DynamoDB 表的简单工具。它基于FastMCP框架，提供类似于 AWS 控制台的体验，用于浏览和筛选 DynamoDB 表数据。

Related MCP server: MariaDB MCP Server

特征

• 扫描 DynamoDB 表（完整或筛选）

• 查看表架构信息

• 分页支持

• 用户体验类似于 AWS 控制台

安装和设置

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 DynamoDB Scanner：

npx -y @smithery/cli install @katpyeon/mcp_dynamodb_scan --client claude

1.克隆存储库

git clone https://github.com/yourusername/mcp_dynamodb_scan.git
cd mcp_dynamodb_scan

2. 设置虚拟环境

# Create virtual environment
python -m venv venv

# Activate virtual environment (Windows)
venv\Scripts\activate

# Activate virtual environment (macOS/Linux)
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

3.Claude配置文件配置

该项目旨在与 Claude 配合使用。请在 Claude 开发者控制台中按如下方式设置您的个人资料：

"dynamodb-scanner": {
  "command": "/Users/yourname/path/mcp_dynamodb_scan/.venv/bin/python",
  "args": ["/Users/yourname/path/mcp_dynamodb_scan/app.py"],
  "env": {
    "DYNAMO_TABLE_NAME": "",
    "AWS_ACCESS_KEY_ID": "",
    "AWS_SECRET_ACCESS_KEY": "",
    "AWS_REGION": ""
  },
  "port": 8080
}

使用适当的值填写环境变量：

• DYNAMO_TABLE_NAME ：要扫描的 DynamoDB 表的名称

• AWS_ACCESS_KEY_ID ：AWS 访问密钥 ID

• AWS_SECRET_ACCESS_KEY ：AWS 秘密访问密钥

• AWS_REGION ：AWS 区域（例如，ap-northeast-2）

用法

要运行该应用程序：

python app.py

FastMCP 服务器将启动，您可以使用它和 Claude 来扫描和过滤 DynamoDB 表。

示例查询

你可以问克劳德：

1. “向我展示表格模式。”

2. “查找名字为‘洪吉童’的物品。”

3. “显示所有用户信息。”

执照

本项目遵循 MIT 许可证。详情请参阅许可证文件。