
DynamoDB MCP Server

2025.01.08
6
JavaScript数据库管理DynamoDB 工具数据库
DynamoDB MCP Server 是一个基于 Model Context Protocol 的服务器,专门用于管理 Amazon DynamoDB 资源。它提供了表管理、容量管理和数据操作等功能,帮助用户高效地管理和操作 DynamoDB 数据库。
View on GitHub
Overview
基本能力
产品定位
DynamoDB MCP Server 是一个专门用于管理 Amazon DynamoDB 资源的工具,通过提供表管理、容量管理和数据操作等功能,帮助用户高效地管理和操作 DynamoDB 数据库。
核心功能
- 表管理
- 创建新的 DynamoDB 表,支持自定义配置
- 列出现有表
- 获取表的详细信息
-
配置表设置
-
索引管理
- 创建和管理全局二级索引 (GSI)
- 更新 GSI 容量
-
创建本地二级索引 (LSI)
-
容量管理
- 更新预置的读写容量单位
-
管理表吞吐量设置
-
数据操作
- 插入或替换表中的项目
- 通过主键检索项目
- 更新特定项目属性
- 使用条件查询表
- 使用过滤器扫描表
注意:不支持删除操作以防止意外数据丢失。
适用场景
- 需要高效管理 DynamoDB 表的开发者和运维人员
- 需要动态调整表容量的场景
- 需要频繁进行数据查询和更新的应用
工具列表
- create_table:创建新的 DynamoDB 表,支持自定义配置。
- list_tables:列出账户中的所有 DynamoDB 表。
- describe_table:获取表的详细信息。
- create_gsi:在表上创建全局二级索引。
- update_gsi:更新全局二级索引的容量。
- create_lsi:在表上创建本地二级索引。
- update_capacity:更新表的预置容量。
- put_item:插入或替换表中的项目。
- get_item:通过主键检索项目。
- update_item:更新表中的特定项目属性。
- query_table:使用条件查询表。
- scan_table:使用过滤器扫描表。
常见问题解答
- 如何创建新表?
-
使用
create_table
工具,指定表名、分区键、分区键类型、读写容量等参数。 -
如何列出所有表?
-
使用
list_tables
工具,可选参数limit
限制返回的表数量。 -
如何更新表的容量?
-
使用
update_capacity
工具,指定表名和新的读写容量。 -
如何插入新项目?
-
使用
put_item
工具,指定表名和项目数据。 -
如何查询表?
- 使用
query_table
工具,指定表名和查询条件。
使用教程
使用依赖
- 安装 Node.js 和 npm。
- 确保已配置 AWS 凭证。
安装教程
- 安装依赖:
npm install
- 配置 AWS 凭证环境变量:
export AWS_ACCESS_KEY_ID="your_access_key"
export AWS_SECRET_ACCESS_KEY="your_secret_key"
export AWS_REGION="your_region"
- 构建服务器:
npm run build
- 启动服务器:
npm start
调试方式
- 运行开发模式(自动重新加载):
npm run dev
- 使用 Docker 构建和运行:
docker build -t mcp/dynamodb-mcp-server -f Dockerfile .
docker run -i --rm -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -e AWS_REGION -e AWS_SESSION_TOKEN mcp/dynamodb-mcp-server