Dynamodb MCP Server

🚀 動態數據庫 MCP 服務器指南

本指南提供的基於 Node.js 的動態數據庫（DynamoDB）管理控制檯（MCP），能讓用戶通過命令輕鬆進行表管理和數據操作，極大提升管理效率。

🚀 快速開始

本指南提供了一個基於 Node.js 的動態數據庫 (DynamoDB) 管理控制檯 (MCP)，允許用戶通過命令進行表管理和數據操作。

✨ 主要特性

• 表管理：可創建、列出和描述表，方便對錶進行全面管理。
• 索引管理：支持添加、刪除和描述全局二次索引 (GSI)，優化數據檢索性能。
• 容量規劃：能更新讀寫容量，還可查看當前容量信息，合理規劃資源。
• 數據操作：支持基本的增刪改查功能，滿足日常數據處理需求。
• 查詢與掃描：可使用條件過濾進行數據檢索，精準定位所需數據。
• 工具支持：配備交互式控制檯和命令行接口，操作方式靈活。

📦 安裝指南

設置 AWS 憑據

1. 從 AWS 管理控制檯獲取訪問密鑰 ID、秘密訪問密鑰和區域信息。
2. 如果使用臨時憑證（例如 IAM 角色），還需獲取會話令牌。
3. 確保這些憑證具備進行 DynamoDB 操作的適當權限。

使用 Claude Desktop

在 claude_desktop_config.json 中添加以下內容：

Docker（推薦）

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

💻 使用示例

表管理命令

基礎用法

# 創建表
create_table <tableName> <partitionKey> <sortKey> [< gsiDefinitions...>]

# 列出所有表
list_tables

# 描述特定表
describe_table <tableName>

# 刪除表
delete_table <tableName>

索引管理命令

基礎用法

# 創建索引
create_index <tableName> <indexName> <partitionKey> [<sortKeys...>]

# 列出所有索引
list_indexes <tableName>

# 描述特定索引
describe_index <tableName> <indexName>

# 刪除索引
delete_index <tableName> <indexName>

容量規劃命令

基礎用法

# 更新表容量
update_capacity <tableName> <readCapacity> <writeCapacity>

# 查看當前容量
get_capacity <tableName>

# 獲取容量預置詳情
get_throughput <tableName>

數據操作命令

基礎用法

# 插入數據
put_item <tableName> <jsonItem>

# 查詢單個項
get_item <tableName> <partitionKey> <sortKey>

# 刪除數據
delete_item <tableName> <partitionKey> <sortKey>

# 更新數據
update_item <tableName> <partitionKey> <sortKey> <expression> <attributeNames...> <attributeValues...>

# 批量寫入
batch_write <tableName> <jsonItems...>

# 批量讀取
batch_read <tableName> <keys...>

查詢與掃描命令

基礎用法

# 表查詢
query_table <tableName> <partitionKey> [<sortKeys...>]

# 表掃描
scan_table <tableName> [<filters...>]

📚 詳細文檔

示例問題

表管理

• "創建一個名為 'Products' 的 DynamoDB 表，使用分區鍵 'productId'（字符串）和排序鍵 'timestamp'（數字）"
• "列出我賬戶下的所有 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' 的用戶"

📄 許可證

本項目採用 Apache License 2.0 許可證。

項目地址

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

⚠️ 重要提示

本文檔是為使用和理解 DynamoDB MCP 服務器而編寫的參考指南。