DynamoDB Scanner

⚠️ 重要通知

• DynamoDB 扫描操作会扫描整个表，可能会产生较高的费用。
• 最大结果大小限制为 1MB，因此您可能需要使用分页来检索所有所需数据。
• 该工具仅推荐用于测试目的。
• 在生产环境中，建议根据您的数据访问模式实现查询操作。
• 在扫描大型数据集时，请注意 DynamoDB 读取容量（RCU）的消耗。

DynamoDB Scanner 是一个简单的工具，用于扫描和过滤 AWS DynamoDB 表。它基于 FastMCP 框架，并提供了类似于 AWS 控制台的体验，以便探索和过滤 DynamoDB 表数据。

功能

• 扫描 DynamoDB 表（全表或过滤）
• 查看表结构信息
• 分页支持
• 类似于 AWS 控制台的用户体验

安装与设置

通过 Smithery 安装

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

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

1. 克隆仓库

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

2. 设置虚拟环境

bash

创建虚拟环境

python -m venv venv

激活虚拟环境 (Windows)

venvScriptsactivate

激活虚拟环境 (macOS/Linux)

source venv/bin/activate

安装依赖

pip install -r requirements.txt

3. Claude 配置文件

该项目设计为与 Claude 一起工作。请在 Claude 开发者控制台中按如下方式设置您的配置文件：

json
"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）

使用方法

要运行应用程序：

bash
python app.py

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

示例查询

您可以向 Claude 提出以下请求：

1. "显示表结构。"
2. "查找名称为 Hong Gil-dong 的项目。"
3. "显示所有用户信息。"

许可证

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