🚀 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'