AWS MCP Server

Instructions

Implementation Reference

• src/mcp_server_aws/server.py:247-260 (handler)

  Handler implementation for the dynamodb_item_scan tool: builds scan parameters from arguments and executes dynamodb_client.scan()

  elif name == "dynamodb_item_scan":
      scan_params = {"TableName": arguments["table_name"]}
  
      if "filter_expression" in arguments:
          scan_params["FilterExpression"] = arguments["filter_expression"]
  
          if "expression_attributes" in arguments:
              attrs = arguments["expression_attributes"]
              if "names" in attrs:
                  scan_params["ExpressionAttributeNames"] = attrs["names"]
              if "values" in attrs:
                  scan_params["ExpressionAttributeValues"] = attrs["values"]
  
      response = dynamodb_client.scan(**scan_params)

• src/mcp_server_aws/tools.py:293-323 (schema)

  Input schema and Tool definition for dynamodb_item_scan, specifying parameters like table_name, filter_expression, and expression_attributes

  Tool(
      name="dynamodb_item_scan",
      description="Scan items in a DynamoDB table",
      inputSchema={
          "type": "object",
          "properties": {
              "table_name": {
                  "type": "string",
                  "description": "Name of the DynamoDB table"
              },
              "filter_expression": {
                  "type": "string",
                  "description": "Filter expression"
              },
              "expression_attributes": {
                  "type": "object",
                  "properties": {
                      "values": {
                          "type": "object",
                          "description": "Expression attribute values"
                      },
                      "names": {
                          "type": "object",
                          "description": "Expression attribute names"
                      }
                  }
              }
          },
          "required": ["table_name"]
      }
  ),

• src/mcp_server_aws/server.py:136-139 (registration)

  Tool registration via the list_tools handler, which returns get_aws_tools() including the dynamodb_item_scan tool definition from tools.py

  async def list_tools() -> list[Tool]:
      """List available AWS tools"""
      logger.debug("Handling list_tools request")
      return get_aws_tools()