# AWS KB Retrieval (Reference) MCP Server

An MCP server implementation for retrieving information from the AWS Knowledge Base using the Bedrock Agent Runtime.

[What is an MCP Server?](https://www.anthropic.com/news/model-context-protocol)

## Characteristics
Attribute|Details|
|-|-|
**Image Source**|Official Image
**Docker Image**|[mcp/aws-kb-retrieval-server](https://hub.docker.com/repository/docker/mcp/aws-kb-retrieval-server)
**Author**|[modelcontextprotocol](https://github.com/modelcontextprotocol)
**Repository**|https://github.com/modelcontextprotocol/servers
**Dockerfile**|https://github.com/modelcontextprotocol/servers/blob/2025.4.6/src/aws-kb-retrieval-server/Dockerfile
**Docker Image built by**|Docker Inc.
**Docker Scout Health Score**| ![Docker Scout Health Score](https://api.scout.docker.com/v1/policy/insights/org-image-score/badge/mcp/aws-kb-retrieval-server)
**Verify Signature**|`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/aws-kb-retrieval-server --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub`
**Licence**|MIT License

## Available Tools
Tools provided by this Server|Short Description
-|-
`retrieve_from_aws_kb`|Performs retrieval from the AWS Knowledge Base using the provided query and Knowledge Base ID.|

---
## Tools Details

#### Tool: **`retrieve_from_aws_kb`**
Performs retrieval from the AWS Knowledge Base using the provided query and Knowledge Base ID.
Parameters|Type|Description
-|-|-
`knowledgeBaseId`|`string`|The ID of the AWS Knowledge Base
`query`|`string`|The query to perform retrieval on
`n`|`number` *optional*|Number of results to retrieve

---
## Use this MCP Server

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

[Why is it safer to run MCP Servers with Docker?](https://www.docker.com/blog/the-model-context-protocol-simplifying-building-ai-apps-with-anthropic-claude-desktop-and-docker/)
