awslabs.dynamodb-mcp-server 1.0.9__tar.gz → 2.0.1__tar.gz

{awslabs_dynamodb_mcp_server-1.0.9 → awslabs_dynamodb_mcp_server-2.0.1}/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.0] - 2025-09-11
+
+### Removed
+
+- **BREAKING CHANGE:** DynamoDB Native API functions have been removed in favour of the [AWS API MCP Server](https://github.com/awslabs/mcp/tree/main/src/aws-api-mcp-server).
+
+- The following functionality has been removed:
+  - Table Operations
+  - Item Operations
+  - Query and Scan Operations
+  - Backup and Recovery Operations
+  - Time to Live Operations
+  - Export Operations
+  - Tags and Resource Policies Operations
+  - Miscellaneous Operations (describe endpoints and describe limits)
+
+- **Migration:** Use the AWS API MCP Server to perform these operations going forward.
+
 ## [1.0.0] - 2025-05-26
 
 ### Removed

{awslabs_dynamodb_mcp_server-1.0.9 → awslabs_dynamodb_mcp_server-2.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.dynamodb-mcp-server
-Version: 1.0.9
+Version: 2.0.1
 Summary: The official MCP Server for interacting with AWS DynamoDB
 Project-URL: homepage, https://awslabs.github.io/mcp/
 Project-URL: docs, https://awslabs.github.io/mcp/servers/dynamodb-mcp-server/
@@ -34,64 +34,48 @@ Description-Content-Type: text/markdown
 
 The official MCP Server for interacting with AWS DynamoDB
 
-This comprehensive server provides both operational DynamoDB management and expert design guidance, featuring 30+ operational tools for managing DynamoDB tables, items, indexes, backups, and more, expert data modeling guidance.
+This server provides expert DynamoDB design guidance and data modeling assistance.
 
 ## Available MCP Tools
 
 ### Design & Modeling
 - `dynamodb_data_modeling` - Retrieves the complete DynamoDB Data Modeling Expert prompt
 
-### Table Operations
-- `create_table` - Creates a new DynamoDB table with optional secondary indexes
-- `delete_table` - Deletes a table and all of its items
-- `describe_table` - Returns table information including status, creation time, key schema and indexes
-- `list_tables` - Returns a paginated list of table names in your account
-- `update_table` - Modifies table settings including provisioned throughput, global secondary indexes, and DynamoDB Streams configuration
-
-### Item Operations
-- `get_item` - Returns attributes for an item with the given primary key
-- `put_item` - Creates a new item or replaces an existing item in a table
-- `update_item` - Edits an existing item's attributes, or adds a new item if it does not already exist
-- `delete_item` - Deletes a single item in a table by primary key
-
-### Query and Scan Operations
-- `query` - Returns items from a table or index matching a partition key value, with optional sort key filtering
-- `scan` - Returns items and attributes by scanning a table or secondary index
-
-### Backup and Recovery
-- `create_backup` - Creates a backup of a DynamoDB table
-- `describe_backup` - Describes an existing backup of a table
-- `list_backups` - Returns a list of table backups
-- `restore_table_from_backup` - Creates a new table from a backup
-- `describe_continuous_backups` - Returns continuous backup and point in time recovery status
-- `update_continuous_backups` - Enables or disables point in time recovery
-
-### Time to Live (TTL)
-- `update_time_to_live` - Enables or disables Time to Live (TTL) for the specified table
-- `describe_time_to_live` - Returns the Time to Live (TTL) settings for a table
-
-### Export Operations
-- `describe_export` - Returns information about a table export
-- `list_exports` - Returns a list of table exports
-
-### Tags and Resource Policies
-- `put_resource_policy` - Attaches a resource-based policy document to a table or stream
-- `get_resource_policy` - Returns the resource-based policy document attached to a table or stream
-- `tag_resource` - Adds tags to a DynamoDB resource
-- `untag_resource` - Removes tags from a DynamoDB resource
-- `list_tags_of_resource` - Returns tags for a DynamoDB resource
-
-### Misc
-- `describe_limits` - Returns the current provisioned-capacity quotas for your AWS account
-- `describe_endpoints` - Returns DynamoDB endpoints for the current region
+## Migration Notice
 
-## Instructions
+Starting with version 2.0.0, this server focuses exclusively on DynamoDB design and modeling guidance. All operational DynamoDB management tools (table operations, item operations, queries, backups, etc.) have been removed in favour of the [AWS API MCP Server](https://github.com/awslabs/mcp/tree/main/src/aws-api-mcp-server) which provides the same capability and more.
+
+### Recommended: AWS API MCP Server
+
+For operational DynamoDB management, use the [AWS API MCP Server](https://github.com/awslabs/mcp/tree/main/src/aws-api-mcp-server) which provides comprehensive AWS service management including all DynamoDB operations. [Migration guide available here](https://github.com/awslabs/mcp/tree/main/src/aws-api-mcp-server).
+
+### Not Recommended: Legacy Version
+
+If you must use the previous operational tools, you can pin to version 1.0.9, though this is not recommended:
+
+```json
+{
+  "mcpServers": {
+    "awslabs.dynamodb-mcp-server": {
+      "command": "uvx",
+      "args": ["awslabs.dynamodb-mcp-server@1.0.9"],
+      "env": {
+        "DDB-MCP-READONLY": "true",
+        "AWS_PROFILE": "default",
+        "AWS_REGION": "us-west-2",
+        "FASTMCP_LOG_LEVEL": "ERROR"
+      },
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
 
-The official MCP Server for interacting with AWS DynamoDB provides a comprehensive set of tools for both designing and managing DynamoDB resources.
+## Instructions
 
-To use these tools, ensure you have proper AWS credentials configured with appropriate permissions for DynamoDB operations. The server will automatically use credentials from environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN) or other standard AWS credential sources.
+This MCP Server provides DynamoDB design and modeling guidance only. For operational DynamoDB management (retrieving data, managing tables, etc.), use the [AWS API MCP Server](https://github.com/awslabs/mcp/tree/main/src/aws-api-mcp-server) which provides comprehensive DynamoDB operations. [Migration guide available here](https://github.com/awslabs/mcp/tree/main/src/aws-api-mcp-server).
 
-All tools support an optional `region_name` parameter to specify which AWS region to operate in. If not provided, it will use the AWS_REGION environment variable or default to 'us-west-2'.
 
 ## Prerequisites
 

{awslabs_dynamodb_mcp_server-1.0.9 → awslabs_dynamodb_mcp_server-2.0.1}/README.md

@@ -2,64 +2,48 @@
 
 The official MCP Server for interacting with AWS DynamoDB
 
-This comprehensive server provides both operational DynamoDB management and expert design guidance, featuring 30+ operational tools for managing DynamoDB tables, items, indexes, backups, and more, expert data modeling guidance.
+This server provides expert DynamoDB design guidance and data modeling assistance.
 
 ## Available MCP Tools
 
 ### Design & Modeling
 - `dynamodb_data_modeling` - Retrieves the complete DynamoDB Data Modeling Expert prompt
 
-### Table Operations
-- `create_table` - Creates a new DynamoDB table with optional secondary indexes
-- `delete_table` - Deletes a table and all of its items
-- `describe_table` - Returns table information including status, creation time, key schema and indexes
-- `list_tables` - Returns a paginated list of table names in your account
-- `update_table` - Modifies table settings including provisioned throughput, global secondary indexes, and DynamoDB Streams configuration
-
-### Item Operations
-- `get_item` - Returns attributes for an item with the given primary key
-- `put_item` - Creates a new item or replaces an existing item in a table
-- `update_item` - Edits an existing item's attributes, or adds a new item if it does not already exist
-- `delete_item` - Deletes a single item in a table by primary key
-
-### Query and Scan Operations
-- `query` - Returns items from a table or index matching a partition key value, with optional sort key filtering
-- `scan` - Returns items and attributes by scanning a table or secondary index
-
-### Backup and Recovery
-- `create_backup` - Creates a backup of a DynamoDB table
-- `describe_backup` - Describes an existing backup of a table
-- `list_backups` - Returns a list of table backups
-- `restore_table_from_backup` - Creates a new table from a backup
-- `describe_continuous_backups` - Returns continuous backup and point in time recovery status
-- `update_continuous_backups` - Enables or disables point in time recovery
-
-### Time to Live (TTL)
-- `update_time_to_live` - Enables or disables Time to Live (TTL) for the specified table
-- `describe_time_to_live` - Returns the Time to Live (TTL) settings for a table
-
-### Export Operations
-- `describe_export` - Returns information about a table export
-- `list_exports` - Returns a list of table exports
-
-### Tags and Resource Policies
-- `put_resource_policy` - Attaches a resource-based policy document to a table or stream
-- `get_resource_policy` - Returns the resource-based policy document attached to a table or stream
-- `tag_resource` - Adds tags to a DynamoDB resource
-- `untag_resource` - Removes tags from a DynamoDB resource
-- `list_tags_of_resource` - Returns tags for a DynamoDB resource
-
-### Misc
-- `describe_limits` - Returns the current provisioned-capacity quotas for your AWS account
-- `describe_endpoints` - Returns DynamoDB endpoints for the current region
+## Migration Notice
 
-## Instructions
+Starting with version 2.0.0, this server focuses exclusively on DynamoDB design and modeling guidance. All operational DynamoDB management tools (table operations, item operations, queries, backups, etc.) have been removed in favour of the [AWS API MCP Server](https://github.com/awslabs/mcp/tree/main/src/aws-api-mcp-server) which provides the same capability and more.
+
+### Recommended: AWS API MCP Server
+
+For operational DynamoDB management, use the [AWS API MCP Server](https://github.com/awslabs/mcp/tree/main/src/aws-api-mcp-server) which provides comprehensive AWS service management including all DynamoDB operations. [Migration guide available here](https://github.com/awslabs/mcp/tree/main/src/aws-api-mcp-server).
+
+### Not Recommended: Legacy Version
+
+If you must use the previous operational tools, you can pin to version 1.0.9, though this is not recommended:
+
+```json
+{
+  "mcpServers": {
+    "awslabs.dynamodb-mcp-server": {
+      "command": "uvx",
+      "args": ["awslabs.dynamodb-mcp-server@1.0.9"],
+      "env": {
+        "DDB-MCP-READONLY": "true",
+        "AWS_PROFILE": "default",
+        "AWS_REGION": "us-west-2",
+        "FASTMCP_LOG_LEVEL": "ERROR"
+      },
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
 
-The official MCP Server for interacting with AWS DynamoDB provides a comprehensive set of tools for both designing and managing DynamoDB resources.
+## Instructions
 
-To use these tools, ensure you have proper AWS credentials configured with appropriate permissions for DynamoDB operations. The server will automatically use credentials from environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN) or other standard AWS credential sources.
+This MCP Server provides DynamoDB design and modeling guidance only. For operational DynamoDB management (retrieving data, managing tables, etc.), use the [AWS API MCP Server](https://github.com/awslabs/mcp/tree/main/src/aws-api-mcp-server) which provides comprehensive DynamoDB operations. [Migration guide available here](https://github.com/awslabs/mcp/tree/main/src/aws-api-mcp-server).
 
-All tools support an optional `region_name` parameter to specify which AWS region to operate in. If not provided, it will use the AWS_REGION environment variable or default to 'us-west-2'.
 
 ## Prerequisites
 

{awslabs_dynamodb_mcp_server-1.0.9 → awslabs_dynamodb_mcp_server-2.0.1}/awslabs/dynamodb_mcp_server/__init__.py

@@ -14,4 +14,4 @@
 
 """awslabs.dynamodb-mcp-server"""
 
-__version__ = '1.0.9'
+__version__ = '2.0.1'

awslabs_dynamodb_mcp_server-2.0.1/awslabs/dynamodb_mcp_server/common.py

@@ -0,0 +1,53 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+from functools import wraps
+from typing import Callable
+
+
+def handle_exceptions(func: Callable) -> Callable:
+    """Decorator to handle exceptions in DynamoDB operations.
+
+    Wraps the function in a try-catch block and returns any exceptions
+    in a standardized error format.
+
+    Args:
+        func: The function to wrap
+
+    Returns:
+        The wrapped function that handles exceptions
+    """
+
+    @wraps(func)
+    async def wrapper(*args, **kwargs):
+        try:
+            return await func(*args, **kwargs)
+        except Exception as e:
+            return {'error': str(e)}
+
+    return wrapper
+
+
+def mutation_check(func):
+    """Decorator to block mutations if DDB-MCP-READONLY is set to true."""
+
+    @wraps(func)
+    async def wrapper(*args, **kwargs):
+        readonly = os.environ.get('DDB-MCP-READONLY', '').lower()
+        if readonly in ('true', '1', 'yes'):  # treat these as true
+            return {'error': 'Mutation not allowed: DDB-MCP-READONLY is set to true.'}
+        return await func(*args, **kwargs)
+
+    return wrapper

awslabs_dynamodb_mcp_server-2.0.1/awslabs/dynamodb_mcp_server/server.py

@@ -0,0 +1,81 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#!/usr/bin/env python3
+
+from awslabs.dynamodb_mcp_server.common import handle_exceptions
+from mcp.server.fastmcp import FastMCP
+from pathlib import Path
+
+
+# Define server instructions and dependencies
+SERVER_INSTRUCTIONS = """The official MCP Server for AWS DynamoDB design and modeling guidance
+
+This server provides DynamoDB design and modeling expertise.
+
+When users ask for dynamodb operational tasks, provide EXACTLY these two options:
+Option 1(RECOMMENDED): AWS API MCP Server
+   Migration guide: https://github.com/awslabs/mcp/tree/main/src/aws-api-mcp-server
+Option 2(NOT RECOMMENDED): Legacy version 1.0.9
+
+Available Tool:
+--------------
+Use the `dynamodb_data_modeling` tool to access enterprise-level DynamoDB design expertise.
+This tool provides systematic methodology for creating production-ready multi-table design with
+advanced optimizations, cost analysis, and integration patterns.
+"""
+
+
+def create_server():
+    """Create and configure the MCP server instance."""
+    return FastMCP(
+        'awslabs.dynamodb-mcp-server',
+        instructions=SERVER_INSTRUCTIONS,
+    )
+
+
+app = create_server()
+
+
+@app.tool()
+@handle_exceptions
+async def dynamodb_data_modeling() -> str:
+    """Retrieves the complete DynamoDB Data Modeling Expert prompt.
+
+    This tool returns a production-ready prompt to help user with data modeling on DynamoDB.
+    The prompt guides through requirements gathering, access pattern analysis, and production-ready
+    schema design. The prompt contains:
+
+    - Structured 2-phase workflow (requirements → final design)
+    - Enterprise design patterns: hot partition analysis, write sharding, sparse GSIs, and more
+    - Cost optimization strategies and RPS-based capacity planning
+    - Multi-table design philosophy with advanced denormalization patterns
+    - Integration guidance for OpenSearch, Lambda, and analytics
+
+    Usage: Simply call this tool to get the expert prompt.
+
+    Returns: Complete expert system prompt as text (no parameters required)
+    """
+    prompt_file = Path(__file__).parent / 'prompts' / 'dynamodb_architect.md'
+    architect_prompt = prompt_file.read_text(encoding='utf-8')
+    return architect_prompt
+
+
+def main():
+    """Main entry point for the MCP server application."""
+    app.run()
+
+
+if __name__ == '__main__':
+    main()

{awslabs_dynamodb_mcp_server-1.0.9 → awslabs_dynamodb_mcp_server-2.0.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "awslabs.dynamodb-mcp-server"
-version = "1.0.9"
+version = "2.0.1"
 description = "The official MCP Server for interacting with AWS DynamoDB"
 readme = "README.md"
 requires-python = ">=3.10"

awslabs_dynamodb_mcp_server-2.0.1/tests/test_dynamodb_server.py

@@ -0,0 +1,53 @@
+import pytest
+import pytest_asyncio
+from awslabs.dynamodb_mcp_server.server import (
+    dynamodb_data_modeling,
+)
+
+
+@pytest_asyncio.fixture
+async def aws_credentials():
+    """Mocked AWS Credentials for moto."""
+    import os
+
+    os.environ['AWS_DEFAULT_REGION'] = 'us-west-2'
+
+
+@pytest.mark.asyncio
+async def test_dynamodb_data_modeling():
+    """Test the dynamodb_data_modeling tool directly."""
+    result = await dynamodb_data_modeling()
+
+    assert isinstance(result, str), 'Expected string response'
+    assert len(result) > 1000, 'Expected substantial content (>1000 characters)'
+
+    expected_sections = [
+        'DynamoDB Data Modeling Expert System Prompt',
+        'Access Patterns Analysis',
+        'Enhanced Aggregate Analysis',
+        'Important DynamoDB Context',
+    ]
+
+    for section in expected_sections:
+        assert section in result, f"Expected section '{section}' not found in content"
+
+
+@pytest.mark.asyncio
+async def test_dynamodb_data_modeling_mcp_integration():
+    """Test the dynamodb_data_modeling tool through MCP client."""
+    from awslabs.dynamodb_mcp_server.server import app
+
+    # Verify tool is registered in the MCP server
+    tools = await app.list_tools()
+    tool_names = [tool.name for tool in tools]
+    assert 'dynamodb_data_modeling' in tool_names, (
+        'dynamodb_data_modeling tool not found in MCP server'
+    )
+
+    # Get tool metadata
+    modeling_tool = next((tool for tool in tools if tool.name == 'dynamodb_data_modeling'), None)
+    assert modeling_tool is not None, 'dynamodb_data_modeling tool not found'
+
+    assert modeling_tool.description is not None
+    assert 'DynamoDB' in modeling_tool.description
+    assert 'data modeling' in modeling_tool.description.lower()

{awslabs_dynamodb_mcp_server-1.0.9 → awslabs_dynamodb_mcp_server-2.0.1}/uv.lock

@@ -194,7 +194,7 @@ wheels = [
 
 [[package]]
 name = "awslabs-dynamodb-mcp-server"
-version = "1.0.9"
+version = "2.0.1"
 source = { editable = "." }
 dependencies = [
     { name = "boto3" },