Dynamodb MCP Server

🚀 動的データベースMCPサーバーガイド

このガイドでは、Node.jsベースの動的データベース（DynamoDB）管理コンソール（MCP）を提供しています。ユーザーはコマンドを通じてテーブル管理とデータ操作を行うことができます。以下に、完全な機能リストを示します。

✨ 主な機能

• テーブル管理：テーブルの作成、一覧表示、および詳細表示
• インデックス管理：グローバルセカンダリインデックス（GSI）の追加、削除、および詳細表示
• 容量計画：読み取りと書き込み容量の更新、現在の容量情報の表示
• データ操作：基本的なデータの追加、削除、更新、および取得機能をサポート
• クエリとスキャン：条件フィルターを使用したデータ検索
• ツールサポート：対話型コンソールとコマンドラインインターフェースを備えています

📚 詳細ドキュメント

テーブル管理コマンド

1. テーブルの作成

create_table <tableName> <partitionKey> <sortKey> [< gsiDefinitions...>]

2. すべてのテーブルを一覧表示

list_tables

3. 特定のテーブルを詳細表示

describe_table <tableName>

4. テーブルの削除

delete_table <tableName>

インデックス管理コマンド

1. インデックスの作成

create_index <tableName> <indexName> <partitionKey> [<sortKeys...>]

2. すべてのインデックスを一覧表示

list_indexes <tableName>

3. 特定のインデックスを詳細表示

describe_index <tableName> <indexName>

4. インデックスの削除

delete_index <tableName> <indexName>

容量計画コマンド

1. テーブルの容量を更新

update_capacity <tableName> <readCapacity> <writeCapacity>

2. 現在の容量を表示

get_capacity <tableName>

3. 容量のプリセット詳細を取得

get_throughput <tableName>

データ操作コマンド

1. データの挿入

put_item <tableName> <jsonItem>

2. 単一の項目を取得

get_item <tableName> <partitionKey> <sortKey>

3. データの削除

delete_item <tableName> <partitionKey> <sortKey>

4. データの更新

update_item <tableName> <partitionKey> <sortKey> <expression> <attributeNames...> <attributeValues...>

5. バッチ書き込み

batch_write <tableName> <jsonItems...>

6. バッチ読み取り

batch_read <tableName> <keys...>

クエリとスキャンコマンド

1. テーブルのクエリ

query_table <tableName> <partitionKey> [<sortKeys...>]

2. テーブルのスキャン

scan_table <tableName> [<filters...>]

サンプル質問

以下は、Claudeに対して問うことができるサンプル質問です。

テーブル管理

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

容量計画

• " 'Users' テーブルの容量を20読み取りユニットと15書き込みユニットに更新する"
• " 'Users' テーブルのEmailIndexインデックスの容量を増やす"
• " 'Orders' テーブルの現在のプリセット容量情報を取得する"

データ操作

• "IDが '123'、名前が 'John Doe'、メールアドレスが 'john@example.com' の新しいユーザーを挿入する"
• "IDが '123' のユーザーを取得する"
• "ユーザー '123' のメールアドレスを 'john.doe@example.com' に更新する"
• "ユーザー '123' が注文したすべての注文を検索する"
• "21歳を超えるすべてのユーザーを一覧表示する"
• "EmailIndexインデックスを使用して、メールアドレスが 'john@example.com' のユーザーを検索する"

設定ガイド

AWS資格情報の設定

1. AWS管理コンソールからアクセスキーID、シークレットアクセスキー、およびリージョン情報を取得します。
2. 一時的な資格情報（例：IAMロール）を使用する場合は、セッショントークンも取得します。
3. これらの資格情報がDynamoDB操作を行うための適切な権限を持っていることを確認します。

Claude Desktopの使用

claude_desktop_config.json に以下の内容を追加します。

Docker（推奨）

{
  "mcpServers": {
    "dynamodb": {
      "command": "docker",
      "image": "amazon/dynamodb-local:latest"
    }
  }
}

プロジェクトのURL

• GitHub：https://github.com/...
• Gitee：https://gitee.com/...

📄 ライセンス

このプロジェクトは、Apache License 2.0ライセンスの下で提供されています。

⚠️ 重要な注意事項

このドキュメントは、DynamoDB MCPサーバーの使用と理解のために作成された参考ガイドです。