AWS KB Retrieval

What it is

An MCP server implementation for retrieving information from the AWS Knowledge Base using the Bedrock Agent Runtime. It provides RAG (Retrieval-Augmented Generation) by returning context from a Knowledge Base based on a query and a Knowledge Base ID. It exposes one tool, retrieve_from_aws_kb, with an optional parameter for the number of results. The repository is in the servers-archived project.

Who it's for

• Developers who want an MCP client such as Claude Desktop or VS Code to query an AWS Knowledge Base
• Teams already using AWS Bedrock Knowledge Bases who need RAG context for an assistant

Requirements

Setup

1. Set up AWS credentials

   Obtain AWS access key ID, secret access key, and region from the AWS Management Console. Ensure these credentials have appropriate permissions for Bedrock Agent Runtime operations.

2. Configure Claude Desktop with npx

   Add this to your claude_desktop_config.json, replacing the placeholder values with your AWS credentials and region.

   jsonCopy

   {
     "mcpServers": {
       "aws-kb-retrieval": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-aws-kb-retrieval"],
         "env": {
           "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY_HERE",
           "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_ACCESS_KEY_HERE",
           "AWS_REGION": "YOUR_AWS_REGION_HERE"
         }
       }
     }
   }

3. Configure Claude Desktop with Docker

   Alternatively, run the server via Docker by adding this to claude_desktop_config.json.

   jsonCopy

   {
     "mcpServers": {
       "aws-kb-retrieval": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-e",
           "AWS_ACCESS_KEY_ID",
           "-e",
           "AWS_SECRET_ACCESS_KEY",
           "-e",
           "AWS_REGION",
           "mcp/aws-kb-retrieval-server"
         ],
         "env": {
           "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY_HERE",
           "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_ACCESS_KEY_HERE",
           "AWS_REGION": "YOUR_AWS_REGION_HERE"
         }
       }
     }
   }

4. Build the Docker image (optional)

   To build the image locally with Docker, run this command.

   shCopy

   docker build -t mcp/aws-kb-retrieval -f src/aws-kb-retrieval-server/Dockerfile .

Examples

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "aws_access_key",
        "description": "AWS Access Key ID",
        "password": true
      },
      {
        "type": "promptString",
        "id": "aws_secret_key",
        "description": "AWS Secret Access Key",
        "password": true
      },
      {
        "type": "promptString",
        "id": "aws_region",
        "description": "AWS Region"
      }
    ],
    "servers": {
      "aws-kb-retrieval": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-aws-kb-retrieval"],
        "env": {
          "AWS_ACCESS_KEY_ID": "${input:aws_access_key}",
          "AWS_SECRET_ACCESS_KEY": "${input:aws_secret_key}",
          "AWS_REGION": "${input:aws_region}"
        }
      }
    }
  }
}

.vscode/mcp.json

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "aws_access_key",
        "description": "AWS Access Key ID",
        "password": true
      },
      {
        "type": "promptString",
        "id": "aws_secret_key",
        "description": "AWS Secret Access Key",
        "password": true
      },
      {
        "type": "promptString",
        "id": "aws_region",
        "description": "AWS Region"
      }
    ],
    "servers": {
      "aws-kb-retrieval": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/aws-kb-retrieval-server"],
        "env": {
          "AWS_ACCESS_KEY_ID": "${input:aws_access_key}",
          "AWS_SECRET_ACCESS_KEY": "${input:aws_secret_key}",
          "AWS_REGION": "${input:aws_region}"
        }
      }
    }
  }
}

Pros & cons

Images