DynamoDB MCP 服务器

用于管理 Amazon DynamoDB 资源的模型上下文协议服务器。此服务器提供用于表管理、容量管理和数据操作的工具。

作者

伊曼·卡米亚比 ( ikmyb@icloud.com )

特征

表管理

• 使用可自定义的配置创建新的 DynamoDB 表

• 列出现有表

• 获取表的详细信息

• 配置表设置

指数管理

• 创建和管理全局二级索引 (GSI)

• 更新 GSI 容量

• 创建本地二级索引 (LSI)

容量管理

• 更新预配置的读/写容量单位

• 管理表吞吐量设置

数据操作

• 插入或替换表中的项目

• 按主键检索项目

• 更新特定项目属性

• 带条件的查询表

• 使用过滤器扫描表格

注意：不支持删除操作，以防止意外数据丢失。

设置

1. 安装依赖项：

2. 将 AWS 凭证配置为环境变量：

3. 构建服务器：

4. 启动服务器：

工具

创建表

使用指定的配置创建一个新的 DynamoDB 表。

参数：

• tableName ：要创建的表的名称

• partitionKey ：分区键的名称

• partitionKeyType ：分区键的类型（S=字符串，N=数字，B=二进制）

• sortKey ：（可选）排序键的名称

• sortKeyType ：（可选）排序键的类型

• readCapacity ：预配置的读取容量单位

• writeCapacity ：预配置的写入容量单位

例子：

列表表

列出账户中的所有 DynamoDB 表。

参数：

• limit ：（可选）返回的最大表数

• exclusiveStartTableName ：（可选）分页起始表的名称

例子：

描述表

获取有关 DynamoDB 表的详细信息。

参数：

• tableName ：要描述的表的名称

例子：

创建_gsi

在表上创建全局二级索引。

参数：

• tableName ：表的名称

• indexName : 新索引的名称

• partitionKey ：索引的分区键

• partitionKeyType ：分区键的类型

• sortKey ：（可选）索引的排序键

• sortKeyType ：（可选）排序键的类型

• projectionType ：投影类型（ALL、KEYS_ONLY、INCLUDE）

• nonKeyAttributes ：（可选）项目的非关键属性

• readCapacity ：预配置的读取容量单位

• writeCapacity ：预配置的写入容量单位

例子：

更新_gsi

更新全局二级索引的预配置容量。

参数：

• tableName ：表的名称

• indexName ：要更新的索引的名称

• readCapacity ：新的读取容量单位

• writeCapacity ：新的写入容量单位

例子：

创建lsi

在表上创建本地二级索引（必须在表创建期间完成）。

参数：

• tableName ：表的名称

• indexName : 新索引的名称

• partitionKey ：表的分区键

• partitionKeyType ：分区键的类型

• sortKey ：索引的排序键

• sortKeyType ：排序键的类型

• projectionType ：投影类型（ALL、KEYS_ONLY、INCLUDE）

• nonKeyAttributes ：（可选）项目的非关键属性

• readCapacity ：（可选）预配置的读取容量单位

• writeCapacity ：（可选）预配置的写入容量单位

例子：

更新容量

更新表的预配置容量。

参数：

• tableName ：表的名称

• readCapacity ：新的读取容量单位

• writeCapacity ：新的写入容量单位

例子：

放置物品

在表中插入或替换项目。

参数：

• tableName ：表的名称

• item ：要放入表中的项目（作为 JSON 对象）

例子：

获取项目

通过主键从表中检索项目。

参数：

• tableName ：表的名称

• key ：要检索的项目的主键

例子：

更新项目

更新表中项目的特定属性。

参数：

• tableName ：表的名称

• key ：要更新的项目的主键

• updateExpression ：更新表达式

• expressionAttributeNames ：属性名称映射

• expressionAttributeValues ：更新表达式的值

• conditionExpression ：（可选）更新条件

• returnValues ：（可选）返回什么值

例子：

查询表

使用关键条件和可选过滤器查询表。

参数：

• tableName ：表的名称

• keyConditionExpression ：关键条件表达式

• expressionAttributeValues ：关键条件表达式的值

• expressionAttributeNames ：（可选）属性名称映射

• filterExpression ：（可选）结果的过滤表达式

• limit ：（可选）返回的最大项目数

例子：

扫描表

使用可选过滤器扫描整个表。

参数：

• tableName ：表的名称

• filterExpression ：（可选）过滤表达式

• expressionAttributeValues ：（可选）过滤表达式的值

• expressionAttributeNames ：（可选）属性名称映射

• limit ：（可选）返回的最大项目数

例子：

示例问题

以下是您在使用此 DynamoDB MCP 服务器时可以向 Claude 询问的一些示例问题：

表管理

• “创建一个名为‘Products’的新 DynamoDB 表，其分区键为‘productId’（字符串），排序键为‘timestamp’（数字）”

• “列出我的账户中的所有 DynamoDB 表”

• “用户表的当前配置是什么？”

• “在用户表的电子邮件字段上添加全局二级索引”

容量管理

• “将用户表容量更新为 20 个读取单元和 15 个写入单元”

• “扩大用户表上的 EmailIndex GSI 容量”

• “订单表的当前配置容量是多少？”

数据操作

• “插入一个新用户，ID 为‘123’，名称为‘John Doe’，电子邮件为‘ john@example.com ’”

• “获取 ID 为‘123’的用户”

• “将用户‘123’的电子邮件地址更新为‘ john.doe@example.com ’”

• “查找用户‘123’下的所有订单”

• “列出所有超过 21 岁的用户”

• “查询 EmailIndex 来查找电子邮件为‘ john@example.com ’的用户”

配置

设置AWS凭证

1. 从 AWS 管理控制台获取 AWS 访问密钥 ID、秘密访问密钥和区域。

2. 如果使用临时凭证（例如 IAM 角色），还可以获取会话令牌。

3. 确保这些凭证具有 DynamoDB 操作的适当权限。

与 Claude Desktop 一起使用

将其添加到您的claude_desktop_config.json中：

Docker（推荐）

建筑

Docker：

发展

要在开发模式下运行并自动重新加载：

执照

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。