Registry / aws / awslabs-dynamodb-mcp-server

awslabs-dynamodb-mcp-server

library2.0.24pypypiunverified

The `awslabs-dynamodb-mcp-server` is an official Model Context Protocol (MCP) server for Amazon DynamoDB, designed to provide expert design guidance and data modeling assistance. It integrates with AI-powered assistants (like Amazon Q Developer) by exposing specialized tools. This server facilitates the design of DynamoDB data models through natural language conversations, validates proposed models, and can generate infrastructure-as-code resources (e.g., CDK applications). As of version 2.x, its primary focus is on data modeling and design; operational tasks like CRUD and table management have been transitioned to the generic AWS API MCP Server.

aws llm-agents database

pip install awslabs-dynamodb-mcp-server

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · AWSLABS-DYNAMODB-M

awslabs-dynamodb-mcp-server

awspythonv2.0.24

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

The `awslabs-dynamodb-mcp-server` is primarily designed to be run as a server and configured within an MCP client (e.g., Amazon Q Developer CLI, Kiro, Cursor). This quickstart provides an example JSON configuration snippet typically placed in a client's `mcp.json` file. The `command` and `args` specify how the client should launch the DynamoDB MCP server, often utilizing `uvx` (a runtime for MCP servers) or Docker. Environment variables like `AWS_REGION` and AWS credentials (e.g., `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`) are crucial for the server to interact with AWS services, usually sourced from your environment or AWS configuration.

{ "mcpServers": { "awslabs.dynamodb-mcp-server": { "command": "uvx", "args": [ "awslabs.dynamodb-mcp-server@latest" ], "env": { "FASTMCP_LOG_LEVEL": "ERROR", "AWS_REGION": "us-west-2", "AWS_ACCESS_KEY_ID": "" // Use os.environ.get('AWS_ACCESS_KEY_ID', '') for actual use }, "disabled": false, "autoApprove": [] } } }

dynamodb-mcp-server --version

Debug

Known issues

breakingBreaking Change in v2.0.0+: Operational DynamoDB management tools (CRUD, table creation, backups) have been removed. Version 2.0.0 and subsequent versions focus exclusively on DynamoDB design and data modeling guidance. For operational tasks, users are advised to use the generic AWS API MCP Server.

fix

For operational DynamoDB management, migrate to using the AWS API MCP Server. If you absolutely require the legacy operational tools, pin your dependency to version 1.0.9, though this is not recommended for new projects.

affects: >=2.0.0

gotchaTelemetry Collection in v3.0.0+: Starting with version 3.0.0 (expected around February 20, 2026), the DynamoDB MCP Server will begin collecting anonymized telemetry data on tool usage. This includes information like tool name, invocation count, duration, error type, and installation details. No sensitive data (e.g., tool inputs/outputs, AWS credentials, PII) will be collected.

fix

Review the telemetry RFC (GitHub issue #2382) for full details on data collected. Users can opt-out of telemetry collection if desired; instructions are typically provided in the official documentation or GitHub README.

affects: >=3.0.0

gotchaAWS Credentials and Permissions: The server requires AWS credentials to interact with DynamoDB. For design and modeling use cases where AI agents should not modify resources, it is strongly recommended to configure AWS credentials with read-only permissions to prevent accidental data loss or unauthorized modifications.

fix

Ensure your AWS credentials (environment variables, shared credentials file, or IAM role) have appropriate, least-privilege permissions for DynamoDB. Specifically, use read-only permissions if modification is not intended.

affects: All versions

gotchaMySQL Integration Requires Environment Variables: To utilize the `source_db_analyzer` tool for analyzing existing MySQL databases, specific environment variables must be set in the MCP server's configuration.

fix

When enabling MySQL integration, set `MYSQL_CLUSTER_ARN`, `MYSQL_SECRET_ARN`, `MYSQL_DATABASE`, and `AWS_REGION` environment variables in your MCP server configuration. `MYSQL_MAX_QUERY_RESULTS` is optional.

affects: All versions with `source_db_analyzer`

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'awslabs.dynamodb_mcp_server'

This error occurs when the 'awslabs.dynamodb_mcp_server' module is not installed in your Python environment.

fix

Install the module using pip: 'pip install awslabs-dynamodb-mcp-server'.

ImportError: cannot import name 'dynamodb_mcp_server' from 'awslabs'

This error occurs when attempting to import 'dynamodb_mcp_server' directly from 'awslabs', which is incorrect.

fix

Use the correct import statement: 'from awslabs.dynamodb_mcp_server import <module_or_function>'.

ModuleNotFoundError: No module named 'mcp.types'

This error occurs when the 'mcp' module is not installed or there's a naming conflict with a local module named 'mcp'.

fix

Ensure the 'mcp' module is installed using pip: 'pip install mcp'. Also, check for any local modules named 'mcp' and rename them to avoid conflicts.

ModuleNotFoundError: No module named 'boto3.dynamodb.conditions.Key'

This error occurs due to incorrect import syntax for the 'Key' class from 'boto3'.

fix

Use the correct import statement: 'from boto3.dynamodb.conditions import Key'.

AttributeError: 'DynamoDB' object has no attribute 'import_table'

This error occurs when attempting to use the 'import_table' method, which does not exist in the 'boto3' DynamoDB client.

fix

Use the 'import_table' method from the 'boto3' DynamoDB service resource: 'dynamodb = boto3.resource('dynamodb'); dynamodb.import_table(...)'.

Upgrade

Version history

2.0.24latest on PyPI · released Apr 9, 2026

Audit

Dependencies

uvrequiredRecommended runtime for executing MCP servers, typically via `uvx`.

AWS CredentialsrequiredRequired for the server to interact with AWS DynamoDB and other AWS services.

DockeroptionalRequired if running the server as a Docker container.

Agent activity

27 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/awslabs/mcp ↗

packagehttps://pypi.org/project/awslabs-dynamodb-mcp-server/ ↗

homepagehttps://awslabs.github.io/mcp/ ↗

docshttps://awslabs.github.io/mcp/servers/dynamodb-mcp-server/ ↗

changeloghttps://github.com/awslabs/mcp/blob/main/src/dynamodb-mcp-server/CHANGELOG.md ↗