Escáner DynamoDB

⚠️ Aviso importante

• La operación de escaneo de DynamoDB escanea toda la tabla, lo que puede generar costos significativos.

• El tamaño máximo del resultado está limitado a 1 MB, por lo que es posible que deba utilizar la paginación para recuperar todos los datos deseados.

• Esta herramienta se recomienda únicamente para fines de prueba.

• Para la producción, es más eficiente implementar operaciones de consulta adaptadas a sus patrones de acceso a datos.

• Tenga en cuenta el consumo de capacidad de lectura (RCU) de DynamoDB al escanear conjuntos de datos grandes.

DynamoDB Scanner es una herramienta sencilla para escanear y filtrar tablas de AWS DynamoDB. Se basa en el framework FastMCP y ofrece una experiencia similar a la de la consola de AWS para explorar y filtrar datos de tablas de DynamoDB.

Related MCP server: AWS MCP Server

Características

• Escanear tablas de DynamoDB (completas o filtradas)

• Ver información del esquema de la tabla

• Soporte de paginación

• Experiencia de usuario similar a la consola de AWS

Instalación y configuración

Instalación mediante herrería

Para instalar DynamoDB Scanner para Claude Desktop automáticamente a través de Smithery :

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

1. Clonar el repositorio

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

2. Configurar el entorno virtual

# 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. Configuración del perfil de Claude

Este proyecto está diseñado para funcionar con Claude. Configura tu perfil en la Consola de Desarrollador de Claude como se indica a continuación:

"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
}

Complete las variables de entorno con los valores apropiados:

• DYNAMO_TABLE_NAME : Nombre de la tabla DynamoDB que se escaneará

• AWS_ACCESS_KEY_ID : ID de clave de acceso de AWS

• AWS_SECRET_ACCESS_KEY : Clave de acceso secreta de AWS

• AWS_REGION : Región de AWS (por ejemplo, ap-northeast-2)

Uso

Para ejecutar la aplicación:

python app.py

Se iniciará el servidor FastMCP y podrás usarlo con Claude para escanear y filtrar tablas de DynamoDB.

Consultas de ejemplo

Puedes preguntarle a Claude:

1. "Muéstrame el esquema de la tabla."

2. "Encuentra artículos cuyo nombre sea 'Hong Gil-dong'".

3. "Muéstrame toda la información del usuario."

Licencia

Este proyecto se distribuye bajo la licencia MIT. Consulte el archivo de licencia para más detalles.