Imankamyabi Dynamodb MCP Server

🚀 DynamoDB MCP 服務器文檔

DynamoDB MCP（管理控制檯平面）服務器是一款與 AWS DynamoDB 交互的命令行工具。它可創建、刪除和更新表，還能執行讀寫、查詢和掃描等數據操作，讓您輕鬆管理和操作 DynamoDB 數據庫。

🚀 快速開始

DynamoDB MCP 服務器為您提供便捷的方式來管理和操作 DynamoDB 數據庫。您可以通過以下步驟快速上手。

✨ 主要特性

• 表管理：支持創建、刪除和更新表。
• 容量規劃：可調整表的讀寫容量。
• 數據操作：能夠插入、查詢、掃描和更新數據。
• 全局二級索引（GSI）：可添加和管理全局二級索引。

📦 安裝指南

Docker 方式（推薦）

使用以下命令拉取 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。

表管理示例問題

• 創建名為 'Products' 的 DynamoDB 表，具有分區鍵 'productId'（字符串）和排序鍵 'timestamp'（數字）
• 列出賬戶中的所有 DynamoDB 表
• 獲取 Users 表的當前配置
• 在 Users 表上添加 email 字段的全局二級索引

容量規劃示例問題

• 更新 Users 表容量為 20 讀單位和 15 寫單位
• 調整 Users 表 EmailIndex GSI 的容量
• 獲取 Orders 表的當前預置容量

數據操作示例問題

• 插入新用戶，ID '123'，名稱 'John Doe'，電子郵件 'john@example.com'
• 獲取 ID 為 '123' 的用戶
• 更新 ID 為 '123' 用戶的電子郵件地址為 'john.doe'