DynamoDB MCP 服务器文档

概述

DynamoDB MCP（管理控制台平面）服务器是一个用于与 AWS DynamoDB 交互的命令行工具。它支持创建、删除和更新表，以及执行数据操作，如读写、查询和扫描。通过此工具，您可以方便地管理和操作 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。

表管理示例问题

• 创建名为 '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