DynamoDB 스캐너

⚠️ 중요 공지

• DynamoDB Scan 작업은 전체 테이블을 스캔하므로 상당한 비용이 발생할 수 있습니다.

• 최대 결과 크기는 1MB로 제한되어 있으므로 원하는 모든 데이터를 검색하려면 페이지 나누기를 사용해야 할 수도 있습니다.

• 이 도구는 테스트 목적으로만 권장됩니다.

• 운영 환경에서는 데이터 접근 패턴에 맞춰 쿼리 작업을 구현하는 것이 더 효율적입니다.

• 대용량 데이터 세트를 스캔할 때는 DynamoDB 읽기 용량(RCU) 소비에 유의하세요.

DynamoDB Scanner는 AWS DynamoDB 테이블을 스캔하고 필터링하는 간단한 도구입니다. FastMCP 프레임워크를 기반으로 하며, DynamoDB 테이블 데이터를 탐색하고 필터링하는 데 있어 AWS 콘솔과 유사한 환경을 제공합니다.

Related MCP server: MariaDB MCP Server

특징

• DynamoDB 테이블 스캔(전체 또는 필터링)

• 테이블 스키마 정보 보기

• 페이지 매김 지원

• AWS 콘솔과 유사한 사용자 경험

설치 및 설정

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 DynamoDB Scanner를 자동으로 설치하려면:

지엑스피1

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 개발자 콘솔에서 다음과 같이 프로필을 설정하세요.

"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 라이선스에 따라 배포됩니다. 자세한 내용은 라이선스 파일을 참조하세요.