动态数据库 MCP 服务器指南

概述

本指南提供了一个基于 Node.js 的动态数据库 (DynamoDB) 管理控制台 (MCP)，允许用户通过命令进行表管理和数据操作。以下是完整的功能列表。

核心特性

• 表管理: 创建、列出和描述表
• 索引管理: 添加、删除和描述全局二次索引 (GSI)
• 容量规划: 更新读写容量，查看当前容量信息
• 数据操作: 支持基本的增删改查功能
• 查询与扫描: 使用条件过滤进行数据检索
• 工具支持: 配备交互式控制台和命令行接口

功能列表

表管理命令

1. 创建表

create_table <tableName> <partitionKey> <sortKey> [< gsiDefinitions...>]

2. 列出所有表

list_tables

3. 描述特定表

describe_table <tableName>

4. 删除表

delete_table <tableName>

索引管理命令

1. 创建索引

create_index <tableName> <indexName> <partitionKey> [<sortKeys...>]

2. 列出所有索引

list_indexes <tableName>

3. 描述特定索引

describe_index <tableName> <indexName>

4. 删除索引

delete_index <tableName> <indexName>

容量规划命令

1. 更新表容量

update_capacity <tableName> <readCapacity> <writeCapacity>

2. 查看当前容量

get_capacity <tableName>

3. 获取容量预置详情

get_throughput <tableName>

数据操作命令

1. 插入数据

put_item <tableName> <jsonItem>

2. 查询单个项

get_item <tableName> <partitionKey> <sortKey>

3. 删除数据

delete_item <tableName> <partitionKey> <sortKey>

4. 更新数据

update_item <tableName> <partitionKey> <sortKey> <expression> <attributeNames...> <attributeValues...>

5. 批量写入

batch_write <tableName> <jsonItems...>

6. 批量读取

batch_read <tableName> <keys...>

查询与扫描命令

1. 表查询

query_table <tableName> <partitionKey> [<sortKeys...>]

2. 表扫描

scan_table <tableName> [<filters...>]

示例问题

以下是您可以询问 Claude 的一些示例问题：

表管理

• "创建一个名为 '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' 的用户"

配置指南

设置 AWS 凭据

1. 从 AWS 管理控制台获取访问密钥 ID、秘密访问密钥和区域信息。
2. 如果使用临时凭证（例如 IAM 角色），还需获取会话令牌。
3. 确保这些凭证具备进行 DynamoDB 操作的适当权限。

使用 Claude Desktop

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

Docker（推荐）

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

项目地址

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

协议

本项目采用 Apache License 2.0 许可证。

注意: 本文档是为使用和理解 DynamoDB MCP 服务器而编写的参考指南。