DynamoDB Read-Only MCP

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

Features

This MCP server provides the following features:

• Table Management Tools:
  • list-tables: View a list of all DynamoDB tables
  • describe-table: View detailed information about a specific table
• Data Query Tools:
  • scan-table: Scan all or part of a table’s data
  • query-table: Search for data that matches specific conditions in a table
  • paginate-query-table: Retrieve data across multiple pages that matches specific conditions
  • get-item: Retrieve an item with a specific key
  • count-items: Calculate the number of items in a table
• Resources:
  • dynamodb-tables-info: A resource that provides metadata for all tables
  • dynamodb-table-schema: A resource that provides schema information for a specific table
• Prompts:
  • dynamodb-query-help: A help prompt for writing DynamoDB queries

Installation and Execution

You can run it without installation using the Run with NPX method below.

Installing via Smithery

To install DynamoDB Read-Only Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @jjikky/dynamo-readonly-mcp --client claude

Installation

1. Clone the repository:

   git clone https://github.com/jjikky/dynamo-readonly-mcp.git
   cd dynamo-readonly-mcp
   

2. Install the required packages:

   npm install
   

3. Create a .env file and set up your AWS credentials:

   AWS_ACCESS_KEY_ID=your_access_key
   AWS_SECRET_ACCESS_KEY=your_secret_key
   AWS_REGION=your_region
   

Build and Run

npm run build
npm start

Connect to Claude Desktop

To use this MCP server with Claude Desktop, you need to modify the Claude Desktop configuration file.

1. Open the Claude Desktop configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the server configuration as follows:

   {
     "mcpServers": {
       "dynamodb-readonly": {
         "command": "node",