awslabs.dynamodb-mcp-server 1.0.0__py3-none-any.whl → 1.0.2__py3-none-any.whl

awslabs/__init__.py

@@ -1,13 +1,16 @@
 # 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. A copy of the License is located at
+# 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
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# 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.
 
 # This file is part of the awslabs namespace.
 # It is intentionally minimal to support PEP 420 namespace packages.

awslabs/dynamodb_mcp_server/__init__.py

@@ -1,13 +1,16 @@
 # 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. A copy of the License is located at
+# 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
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# 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.
 
 """awslabs.dynamodb-mcp-server"""
 

awslabs/dynamodb_mcp_server/common.py

@@ -1,3 +1,17 @@
+# 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 Any, Callable, Dict, List, Literal, Optional

awslabs/dynamodb_mcp_server/server.py

@@ -1,3 +1,17 @@
+# 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
 
 import boto3
@@ -40,8 +54,51 @@ from typing import Any, Dict, List, Literal, Union
 
 app = FastMCP(
     name='dynamodb-server',
-    instructions='The official MCP Server for interacting with AWS DynamoDB',
-    version='0.1.1',
+    instructions="""The official MCP Server for interacting with AWS DynamoDB
+
+IMPORTANT: DynamoDB Attribute Value Format
+-----------------------------------------
+When working with DynamoDB, all attribute values must be specified with their data types.
+Each attribute value is represented as a dictionary with a single key-value pair where the key
+is the data type and the value is the data itself:
+
+- S: String
+  Example: {"S": "Hello"}
+
+- N: Number (sent as a string)
+  Example: {"N": "123.45"}
+
+- B: Binary data (Base64-encoded)
+  Example: {"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"}
+
+- BOOL: Boolean value
+  Example: {"BOOL": true}
+
+- NULL: Null value
+  Example: {"NULL": true}
+
+- L: List of AttributeValue objects
+  Example: {"L": [{"S": "Cookies"}, {"S": "Coffee"}, {"N": "3.14159"}]}
+
+- M: Map of attribute name/value pairs
+  Example: {"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}}
+
+- SS: String Set (array of strings)
+  Example: {"SS": ["Giraffe", "Hippo", "Zebra"]}
+
+- NS: Number Set (array of strings representing numbers)
+  Example: {"NS": ["42.2", "-19", "7.5", "3.14"]}
+
+- BS: Binary Set (array of Base64-encoded binary data objects)
+  Example: {"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]}
+
+Common usage examples:
+- Primary key: {"userId": {"S": "user123"}}
+- Composite key: {"userId": {"S": "user123"}, "timestamp": {"N": "1612345678"}}
+- Expression attribute values: {":minScore": {"N": "100"}, ":active": {"BOOL": true}}
+- Complete item: {"userId": {"S": "user123"}, "score": {"N": "100"}, "data": {"B": "binarydata=="}}
+""",
+    version='0.1.2',
 )
 
 
@@ -67,7 +124,9 @@ index_name = Field(
     default=None,
     description='The name of a GSI',
 )
-key: Dict[str, KeyAttributeValue] = Field(description='The primary key of an item')
+key: Dict[str, KeyAttributeValue] = Field(
+    description='The primary key of an item. Must use DynamoDB attribute value format (see IMPORTANT note about DynamoDB Attribute Value Format).'
+)
 filter_expression: str = Field(
     default=None,
     description='Filter conditions expression that DynamoDB applies to filter out data',
@@ -80,7 +139,8 @@ expression_attribute_names: Dict[str, str] = Field(
     default=None, description='Substitution tokens for attribute names in an expression.'
 )
 expression_attribute_values: Dict[str, AttributeValue] = Field(
-    default=None, description='Values that can be substituted in an expression'
+    default=None,
+    description='Values that can be substituted in an expression. Must use DynamoDB attribute value format (see IMPORTANT note about DynamoDB Attribute Value Format).',
 )
 select: Select = Field(
     default=None,
@@ -88,7 +148,8 @@ select: Select = Field(
 )
 limit: int = Field(default=None, description='The maximum number of items to evaluate', ge=1)
 exclusive_start_key: Dict[str, KeyAttributeValue] = Field(
-    default=None, description='Use the LastEvaluatedKey from the previous call.'
+    default=None,
+    description='Use the LastEvaluatedKey from the previous call. Must use DynamoDB attribute value format (see IMPORTANT note about DynamoDB Attribute Value Format).',
 )
 
 billing_mode: Literal['PROVISIONED', 'PAY_PER_REQUEST'] = Field(
@@ -310,7 +371,7 @@ async def get_item(
 async def put_item(
     table_name: str = table_name,
     item: Dict[str, AttributeValue] = Field(
-        description='A map of attribute name/value pairs, one for each attribute.'
+        description='A map of attribute name/value pairs, one for each attribute. Must use DynamoDB attribute value format (see IMPORTANT note about DynamoDB Attribute Value Format).'
     ),
     condition_expression: str = Field(
         default=None,

{awslabs_dynamodb_mcp_server-1.0.0.dist-info → awslabs_dynamodb_mcp_server-1.0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.dynamodb-mcp-server
-Version: 1.0.0
+Version: 1.0.2
 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/
@@ -116,7 +116,7 @@ Add the MCP to your favorite agentic tools. e.g. for Amazon Q Developer CLI MCP,
 }
 ```
 
-or docker after a succesful `docker build -t awslabs/dynamodb-mcp-server .`:
+or docker after a successful `docker build -t awslabs/dynamodb-mcp-server .`:
 
 ```json
   {

awslabs_dynamodb_mcp_server-1.0.2.dist-info/RECORD

@@ -0,0 +1,10 @@
+awslabs/__init__.py,sha256=WuqxdDgUZylWNmVoPKiK7qGsTB_G4UmuXIrJ-VBwDew,731
+awslabs/dynamodb_mcp_server/__init__.py,sha256=fjepFDvi4XcDm6PyjZL6NcA7CqQF4lyficHovM3yrdk,673
+awslabs/dynamodb_mcp_server/common.py,sha256=aj1uOGa63TQdM3r75Zht74y1OGgUblDEQ-0h1RZHfn0,11422
+awslabs/dynamodb_mcp_server/server.py,sha256=V-fhlA3dHVTSlK8hDomRGciFI0C8sY4KFzRH5G3GdyQ,34815
+awslabs_dynamodb_mcp_server-1.0.2.dist-info/METADATA,sha256=GmLNGdrsYLWw2lfw7OwvH6mpefi8HmfQ4IOU2ZQyCaw,5893
+awslabs_dynamodb_mcp_server-1.0.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+awslabs_dynamodb_mcp_server-1.0.2.dist-info/entry_points.txt,sha256=Vn6TvAN9d67Lsbkcs0UcIiOBI5xDpNBm_MOOzc1h-YU,88
+awslabs_dynamodb_mcp_server-1.0.2.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
+awslabs_dynamodb_mcp_server-1.0.2.dist-info/licenses/NOTICE,sha256=47UMmTFkf8rUc_JaJfdWe6NsAJQOcZNPZIL6JzU_k5U,95
+awslabs_dynamodb_mcp_server-1.0.2.dist-info/RECORD,,

awslabs_dynamodb_mcp_server-1.0.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-awslabs/__init__.py,sha256=47wJeKcStxEJwX7SVVV2pnAWYR8FxcaYoT3YTmZ5Plg,674
-awslabs/dynamodb_mcp_server/__init__.py,sha256=v9gwAZRDfCdRfC-s0e9gUXPK3rzXrdHjBywl4e05cGs,616
-awslabs/dynamodb_mcp_server/common.py,sha256=TP05-UxC7b_IUfuO_Y-DsySPfkAmPl29ltgleemHfWk,10806
-awslabs/dynamodb_mcp_server/server.py,sha256=yjEvGXecHaUnwoDLy5UPy_A5repNLltduXQclejy9pA,32307
-awslabs_dynamodb_mcp_server-1.0.0.dist-info/METADATA,sha256=8yuKIKsejg7ubjyTkzzddk1w_snPyo1myTQZ8YqOJLA,5892
-awslabs_dynamodb_mcp_server-1.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-awslabs_dynamodb_mcp_server-1.0.0.dist-info/entry_points.txt,sha256=Vn6TvAN9d67Lsbkcs0UcIiOBI5xDpNBm_MOOzc1h-YU,88
-awslabs_dynamodb_mcp_server-1.0.0.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
-awslabs_dynamodb_mcp_server-1.0.0.dist-info/licenses/NOTICE,sha256=47UMmTFkf8rUc_JaJfdWe6NsAJQOcZNPZIL6JzU_k5U,95
-awslabs_dynamodb_mcp_server-1.0.0.dist-info/RECORD,,