DynamoDB Read-Only MCP

What is DynamoDB Read-Only MCP?

A server that utilizes the Model Context Protocol (MCP) to query AWS DynamoDB databases. It allows LLMs like Claude to query DynamoDB data through natural language requests.

How to use DynamoDB Read-Only MCP?

Install via npm (npm install from cloned repo or npx -y dynamo-readonly-mcp), then set AWS credentials (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION) in a .env file or environment variables. Build with npm run build and start with npm start. Connect to Claude Desktop by adding a server entry to claude_desktop_config.json pointing to the built index.js or using npx directly.

Key features of DynamoDB Read-Only MCP

• Table management: list-tables, describe-table
• Data query tools: scan-table, query-table, paginate-query-table, get-item, count-items
• Resources: dynamodb-tables-info, dynamodb-table-schema
• Prompt template: dynamodb-query-help for writing queries
• Read-only access to DynamoDB data

Use cases of DynamoDB Read-Only MCP

• Ask an LLM to list all DynamoDB tables and their structures
• Query table data by specifying conditions in natural language
• Count items in a table matching a given group ID
• Paginate through large result sets with paginate-query-table
• Retrieve a single item by its key using get-item

FAQ from DynamoDB Read-Only MCP

What tools does the server provide?

The server provides list-tables, describe-table, scan-table, query-table, paginate-query-table, get-item, and count-items.

How do I configure AWS credentials?

Set AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_REGION either in a .env file or as environment variables in the Claude Desktop configuration.

Is the server read-only?

Yes, all tools and resources are designed for read-only queries; no write operations are exposed.

What transport does the MCP server use?

It uses StdioServerTransport, communicating via standard input/output with the client.

Is there a built-in prompt for help?

Yes, the dynamodb-query-help prompt provides guidance for writing DynamoDB queries.