Imankamyabi Dynamodb MCP Server

🚀 DynamoDB MCP サーバードキュメント

DynamoDB MCP（管理コンソール平面）サーバーは、AWS DynamoDB とやり取りするためのコマンドラインツールです。このツールを使用すると、テーブルの作成、削除、更新や、データの読み書き、クエリ、スキャンなどの操作を簡単に行うことができます。

✨ 主な機能

• テーブル管理：テーブルの作成、削除、更新を行います。
• 容量計画：テーブルの読み書き容量を調整します。
• データ操作：データの挿入、クエリ、スキャン、更新を行います。
• グローバルセカンダリインデックス（GSI）：グローバルセカンダリインデックスの追加と管理を行います。

📦 インストール

Docker 方式（推奨）

docker pull mcp/dynamodb-mcp-server

手動構築

ソースコードをダウンロードし、依存関係をインストールして構築します。

💻 使用例

基本的な使用法

テーブルの作成

簡単な DynamoDB テーブルを作成します。

create_table \
  --table-name Users \
  --key-schema KeySchema=[{KeyType=HASH, AttributeName=userId}, {KeyType=RANGE, AttributeName=timestamp}] \
  --provisioned-throughput ReadCapacityUnits=5, WriteCapacityUnits=5

グローバルセカンダリインデックス付きのテーブルを作成します。

create_table \
  --table-name Users \
  --key-schema KeySchema=[{KeyType=HASH, AttributeName=userId}, {KeyType=RANGE, AttributeName=timestamp}] \
  --provisioned-throughput ReadCapacityUnits=5, WriteCapacityUnits=5 \
  --global-secondary-indexes GlobalSecondaryIndexes=[{
    IndexName=UserByEmail,
    KeySchema=[{KeyType=HASH, AttributeName=email}],
    Projection=Projection=[{ProjectionType=ALL}],
    ProvisionedThroughput=ProvisionedThroughput={ReadCapacityUnits=2, WriteCapacityUnits=2}
  }]

テーブルの削除

指定した名前のテーブルを削除します。

delete_table --table-name Users

テーブル容量の更新

テーブルの読み書き容量を更新します。

update_table \
  --table-name Users \
  --provisioned-throughput ReadCapacityUnits=10, WriteCapacityUnits=8

データの挿入

テーブルにレコードを挿入します。

put_item \
  --table-name Users \
  --item {userId: S=123, timestamp: N=1679000000, name: S=John Doe, email: S=john@example.com}

データのクエリ

主キーを使用してレコードをクエリします。

get_item \
  --table-name Users \
  --key {userId=S(123), timestamp=N(1679000000)}

データの更新

指定したエントリの一部の属性を更新します。

update_item \
  --table-name Users \
  --key {userId=S(123)} \
  --update-expression "SET #n = :name" \
  --expression-attribute-names "#n": name \
  --expression-attribute-values ":name": Jane Doe

テーブルのスキャン

テーブル全体をスキャンし、すべてのレコードを返します。

scan_table --table-name Users

高度な使用法

完全なコマンドリストを表示するには、dynamodb-mcp-server help を実行してください。

📚 ドキュメント

テーブル管理の例

• パーティションキー 'productId'（文字列）とソートキー 'timestamp'（数値）を持つ 'Products' という名前の DynamoDB テーブルを作成する
• アカウント内のすべての DynamoDB テーブルをリストする
• Users テーブルの現在の設定を取得する
• Users テーブルに email フィールドのグローバルセカンダリインデックスを追加する

容量計画の例

• Users テーブルの容量を 20 読み取りユニットと 15 書き込みユニットに更新する
• Users テーブルの EmailIndex GSI の容量を調整する
• Orders テーブルの現在のプロビジョニング容量を取得する

データ操作の例

• ID '123'、名前 'John Doe'、メールアドレス 'john@example.com' の新しいユーザーを挿入する
• ID が '123' のユーザーを取得する
• ID が '123' のユーザーのメールアドレスを 'john.doe' に更新する