Markdown Content: mcp/src/aws-documentation-mcp-server at main · awslabs/mcp · GitHub

===============

Skip to content Navigation Menu

Toggle navigation

Sign in

Appearance settings

• Product

*   [GitHub Copilot Write better code with AI](https://github.com/features/copilot)
*   [GitHub Spark New Build and deploy intelligent apps](https://github.com/features/spark)
*   [GitHub Models New Manage and compare prompts](https://github.com/features/models)
*   [GitHub Advanced Security Find and fix vulnerabilities](https://github.com/security/advanced-security)
*   [Actions Automate any workflow](https://github.com/features/actions)

*   [Codespaces Instant dev environments](https://github.com/features/codespaces)
*   [Issues Plan and track work](https://github.com/features/issues)
*   [Code Review Manage code changes](https://github.com/features/code-review)
*   [Discussions Collaborate outside of code](https://github.com/features/discussions)
*   [Code Search Find more, search less](https://github.com/features/code-search)

Explore * Why GitHub * All features * Documentation * GitHub Skills * Blog

• Solutions

By company size * Enterprises * Small and medium teams * Startups * Nonprofits

By use case * DevSecOps * DevOps * CI/CD * View all use cases

By industry * Healthcare * Financial services * Manufacturing * Government * View all industries

View all solutions

• Resources

Topics * AI * DevOps * Security * Software Development * View all

Explore * Learning Pathways * Events & Webinars * Ebooks & Whitepapers * Customer Stories * Partners * Executive Insights

• Open Source

*   [GitHub Sponsors Fund open source developers](https://github.com/sponsors)

*   [The ReadME Project GitHub community articles](https://github.com/readme)

Repositories * Topics * Trending * Collections

• Enterprise

*   [Enterprise platform AI-powered developer platform](https://github.com/enterprise)

Available add-ons * GitHub Advanced Security Enterprise-grade security features * Copilot for business Enterprise-grade AI features * Premium Support Enterprise-grade 24/7 support

• Pricing

Search or jump to...

Search code, repositories, users, issues, pull requests...

Search

Clear

Search syntax tips

Provide feedback

We read every piece of feedback, and take your input very seriously.

• [x] Include my email address so I can be contacted

Cancel Submit feedback

Saved searches

Use saved searches to filter your results more quickly

Name

Query

To see all available qualifiers, see our documentation.

Cancel Create saved search

Sign in

Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert

{{ message }}

awslabs/**mcp**Public

• NotificationsYou must be signed in to change notification settings

• Fork 683

• Star 5.2k

• Code

• Issues 139

• Pull requests 53

• Discussions

• Actions

• Projects 1

• Security### Uh oh! There was an error while loading.Please reload this page.

• Insights

Additional navigation options

• Code
• Issues
• Pull requests
• Discussions
• Actions
• Projects
• Security
• Insights

Collapse file tree

Files

main

Search this repository

•     .devcontainer  
  

•     .github  
  

•     docs  
  

•     docusaurus  
  

•     samples  
  

•     src  
  

  •      amazon-kendra-index-mcp-server  
    

  •      amazon-keyspaces-mcp-server  
    

  •      amazon-mq-mcp-server  
    

  •      amazon-neptune-mcp-server  
    

  •      amazon-qbusiness-anonymous-mcp-server  
    

  •      amazon-qindex-mcp-server  
    

  •      amazon-rekognition-mcp-server  
    

  •      amazon-sns-sqs-mcp-server  
    

  •      aurora-dsql-mcp-server  
    

  •      aws-api-mcp-server  
    

  •      aws-bedrock-data-automation-mcp-server  
    

  •      aws-dataprocessing-mcp-server  
    

  •      aws-diagram-mcp-server  
    

  •      aws-documentation-mcp-server  
    

    •       awslabs  
      

    •       tests  
      

    •     .gitignore  
      

    •     .python-version  
      

    •     CHANGELOG.md  
      

    •     Dockerfile  
      

    •     LICENSE  
      

    •     NOTICE  
      

    •     README.md  
      

    •     basic-usage.gif  
      

    •     docker-healthcheck.sh  
      

    •     pyproject.toml  
      

    •     uv-requirements.txt  
      

    •     uv.lock  
      

  •      aws-healthomics-mcp-server  
    

  •      aws-knowledge-mcp-server  
    

  •      aws-location-mcp-server  
    

  •      aws-msk-mcp-server  
    

  •      aws-pricing-mcp-server  
    

  •      aws-serverless-mcp-server  
    

  •      aws-support-mcp-server  
    

  •      bedrock-kb-retrieval-mcp-server  
    

  •      cdk-mcp-server  
    

  •      cfn-mcp-server  
    

  •      cloudwatch-appsignals-mcp-server  
    

  •      cloudwatch-logs-mcp-server  
    

  •      cloudwatch-mcp-server  
    

  •      code-doc-gen-mcp-server  
    

  •      core-mcp-server  
    

  •      cost-explorer-mcp-server  
    

  •      documentdb-mcp-server  
    

  •      dynamodb-mcp-server  
    

  •      ecs-mcp-server  
    

  •      eks-mcp-server  
    

  •      elasticache-mcp-server  
    

  •      finch-mcp-server  
    

  •      frontend-mcp-server  
    

  •      git-repo-research-mcp-server  
    

  •      iam-mcp-server  
    

  •      lambda-tool-mcp-server  
    

  •      mcp-lambda-handler  
    

  •      memcached-mcp-server  
    

  •      mysql-mcp-server  
    

  •      nova-canvas-mcp-server  
    

  •      openapi-mcp-server  
    

  •      postgres-mcp-server  
    

  •      prometheus-mcp-server  
    

  •      redshift-mcp-server  
    

  •      s3-tables-mcp-server  
    

  •      stepfunctions-tool-mcp-server  
    

  •      syntheticdata-mcp-server  
    

  •      terraform-mcp-server  
    

  •      timestream-for-influxdb-mcp-server  
    

  •      valkey-mcp-server  
    

•   .gitignore  
  

•   .pre-commit-config.yaml  
  

•   .python-version  
  

•   .ruff.toml  
  

•   .secrets.baseline  
  

•   CODE_OF_CONDUCT.md  
  

•   CONTRIBUTING.md  
  

•   DESIGN_GUIDELINES.md  
  

•   DEVELOPER_GUIDE.md  
  

•   LICENSE  
  

•   NOTICE  
  

•   README.md  
  

•   VIBE_CODING_TIPS_TRICKS.md  
  

Breadcrumbs

1. mcp
2. /src

/ aws-documentation-mcp-server

/

Copy path

Directory actions

More options

More options

Directory actions

More options

More options

Latest commit

awslabs-mcp

Automatic update of packages

success

Jul 18, 2025

cebabf7·Jul 18, 2025

History

History

Open commit details

Breadcrumbs

1. mcp
2. /src

/ aws-documentation-mcp-server

/

Top

Folders and files

Name	Name	Last commit message	Last commit date
### parent directory ..
awslabs	awslabs	feat: Session id with query param (#640)	Jun 23, 2025
tests	tests	feat: Session id with query param (#640)	Jun 23, 2025
.gitignore	.gitignore	Add AWS Documentation MCP (#59)	Apr 3, 2025
.python-version	.python-version	Add AWS Documentation MCP (#59)	Apr 3, 2025
CHANGELOG.md	CHANGELOG.md	feat(documentation): add support for AWS China docs (#519)	Jun 5, 2025
Dockerfile	Dockerfile	feat: shrink dockerfile (#833)	Jul 18, 2025
LICENSE	LICENSE	feat: update project meta data (#121)	Apr 13, 2025
NOTICE	NOTICE	feat: update project meta data (#121)	Apr 13, 2025
README.md	README.md	chore: Adding VS code link to the readme (#823)	Jul 16, 2025
basic-usage.gif	basic-usage.gif	support reading code examples from AWS Documentation (#72)	Apr 4, 2025
docker-healthcheck.sh	docker-healthcheck.sh	feat: shrink dockerfile (#833)	Jul 18, 2025
pyproject.toml	pyproject.toml	Automatic update of packages	Jul 18, 2025
uv-requirements.txt	uv-requirements.txt	fix: pin pip via hashes in Dockerfile (#642)	Jun 24, 2025
uv.lock	uv.lock	chore(deps): upgrade mcp dep (#851)	Jul 17, 2025
View all files

README.md

Outline

AWS Documentation MCP Server

Model Context Protocol (MCP) server for AWS Documentation

This MCP server provides tools to access AWS documentation, search for content, and get recommendations.

Features

• Read Documentation: Fetch and convert AWS documentation pages to markdown format
• Search Documentation: Search AWS documentation using the official search API (global only)
• Recommendations: Get content recommendations for AWS documentation pages (global only)
• Get Available Services List: Get a list of available AWS services in China regions (China only)

Prerequisites

Installation Requirements

1. Install uv from Astral or the GitHub README
2. Install Python 3.10 or newer using uv python install 3.10 (or a more recent version)

Installation

Cursor	VS Code

Configure the MCP server in your MCP client configuration (e.g., for Amazon Q Developer CLI, edit ~/.aws/amazonq/mcp.json):

undefinedjson { "mcpServers": { "awslabs.aws-documentation-mcp-server": { "command": "uvx", "args": ["awslabs.aws-documentation-mcp-server@latest"], "env": { "FASTMCP_LOG_LEVEL": "ERROR", "AWS_DOCUMENTATION_PARTITION": "aws" }, "disabled": false, "autoApprove": [] } } } undefined

Note: Set AWS_DOCUMENTATION_PARTITION to aws-cn to query AWS China documentation instead of global AWS documentation.

or docker after a successful docker build -t mcp/aws-documentation .:

undefinedjson { "mcpServers": { "awslabs.aws-documentation-mcp-server": { "command": "docker", "args": [ "run", "--rm", "--interactive", "--env", "FASTMCP_LOG_LEVEL=ERROR", "--env", "AWS_DOCUMENTATION_PARTITION=aws", "mcp/aws-documentation:latest" ], "env": {}, "disabled": false, "autoApprove": [] } } } undefined

Basic Usage

Example:

• "look up documentation on S3 bucket naming rule. cite your sources"
• "recommend content for page https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html"

Tools

read_documentation

Fetches an AWS documentation page and converts it to markdown format.

undefinedpython read_documentation(url: str) -> str undefined

search_documentation (global only)

Searches AWS documentation using the official AWS Documentation Search API.

undefinedpython search_documentation(search_phrase: str, limit: int) -> list[dict] undefined

recommend (global only)

Gets content recommendations for an AWS documentation page.

undefinedpython recommend(url: str) -> list[dict] undefined

get_available_services (China only)

Gets a list of available AWS services in China regions.

undefinedpython get_available_services() -> str undefined

Footer

© 2025 GitHub,Inc.

Footer navigation

• Terms
• Privacy
• Security
• Status
• Docs
• Contact
• Manage cookies
• Do not share my personal information

You can’t perform that action at this time.