DynamoDB スキャナー

⚠️重要なお知らせ

• DynamoDB スキャン操作ではテーブル全体がスキャンされるため、多大なコストが発生する可能性があります。

• 結果の最大サイズは 1 MB に制限されているため、必要なすべてのデータを取得するにはページ区切りを使用する必要がある場合があります。

• このツールはテスト目的にのみ推奨されます。

• 運用環境では、データ アクセス パターンに合わせてクエリ操作を実装する方が効率的です。

• 大規模なデータセットをスキャンするときは、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開発者コンソールで以下の手順でプロフィールを設定してください。

"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ライセンスに基づいて配布されています。詳細はLICENSEファイルをご覧ください。