DynamoDB MCP Server

A Model Context Protocol server for managing Amazon DynamoDB resources. This server provides tools for table management, capacity management, and data operations.

Author

Iman Kamyabi ([email protected])

Features

Table Management

• Create new DynamoDB tables with customizable configurations
• List existing tables
• Get detailed table information
• Configure table settings

Index Management

• Create and manage Global Secondary Indexes (GSI)
• Update GSI capacity
• Create Local Secondary Indexes (LSI)

Capacity Management

• Update provisioned read/write capacity units
• Manage table throughput settings

Data Operations

• Insert or replace items in tables
• Retrieve items by primary key
• Update specific item attributes
• Query tables with conditions
• Scan tables with filters

Note: Delete operations are not supported to prevent accidental data loss.

Setup

1. Install dependencies:

npm install

2. Configure AWS credentials as environment variables:

export AWS_ACCESS_KEY_ID="your_access_key"
export AWS_SECRET_ACCESS_KEY="your_secret_key"
export AWS_REGION="your_region"

3. Build the server:

npm run build

4. Start the server:

npm start

Tools

create_table

Creates a new DynamoDB table with specified configuration.

Parameters:

• tableName: Name of the table to create
• partitionKey: Name of the partition key
• partitionKeyType: Type of partition key (S=String, N=Number, B=Binary)
• sortKey: (Optional) Name of the sort key
• sortKeyType: (Optional) Type of sort key
• readCapacity: Provisioned read capacity units
• writeCapacity: Provisioned write capacity units

Example:

{
  "tableName": "Users",
  "partitionKey": "userId",
  "partitionKeyType": "S",
  "readCapacity": 5,
  "writeCapacity": 5
}

list_tables

Lists all DynamoDB tables in the account.

Parameters:

• limit: (Optional) Maximum number of tables to return
• exclusiveStartTableName: (Optional) Name of the table to start from for pagination

Example:

{
  "limit": 10
}

describe_table

Gets detailed information about a DynamoDB table.

Parameters:

• tableName: Name of the table to describe

Example:

{
  "tableName": "Users"
}

create_gsi

Creates a global secondary index on a table.

Parameters:

• tableName: Name of the table
• indexName: Name of the new index
• partitionKey: Partition key for the index
• partitionKeyType: Type of partition key
• sortKey: (Optional) Sort key for the index
• sortKeyType: (Optional) Type of sort key
• projectionType: Type of projection (ALL, KEYS_ONLY, INCLUDE)
• nonKeyAttributes: (Optional) Non-key attributes to project
• readCapacity: Provisioned read capacity units
• writeCapacity: Provisioned write capacity units

Example:

{
  "tableName": "Users",
  "indexName": "EmailIndex",
  "partitionKey": "email",