Markdown Content: mcp/src/core-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  
    

  •      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  
    

    •       awslabs  
      

    •       tests  
      

    •     .gitignore  
      

    •     .python-version  
      

    •     CHANGELOG.md  
      

    •     Dockerfile  
      

    •     LICENSE  
      

    •     NOTICE  
      

    •     README.md  
      

    •     docker-healthcheck.sh  
      

    •     pyproject.toml  
      

    •     uv-requirements.txt  
      

    •     uv.lock  
      

  •      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

/ core-mcp-server

/

Copy path

Directory actions

More options

More options

Directory actions

More options

More options

Latest commit

3 people

chore: update core (#906)

Open commit details success

Aug 1, 2025

dcde90b·Aug 1, 2025

History

History

Open commit details

Breadcrumbs

1. mcp
2. /src

/ core-mcp-server

/

Top

Folders and files

Name	Name	Last commit message	Last commit date
### parent directory ..
awslabs	awslabs	chore: update core (#906)	Aug 1, 2025
tests	tests	[feat: fix and check license header automation (](https://github.com/awslabs/mcp/commit/6827ea31fbdef08e648b0c422e4158f913001f59 "feat: fix and check license header automation (#510) * feat: check license header Signed-off-by: Scott Schreckengaust [email protected] * fix: add line break Signed-off-by: Scott Schreckengaust [email protected] * fix: lots of files Signed-off-by: Scott Schreckengaust [email protected] * fix: even more Signed-off-by: Scott Schreckengaust [email protected] * Revert \"fix: add line break\" This reverts commit 122fc210da47b9db4ecf382cd271921f5929cbb8. * feat: check license header configuration Signed-off-by: Scott Schreckengaust [email protected] * fix: cover excluded files from licenses Signed-off-by: Scott Schreckengaust [email protected] * fix: all files to match header Signed-off-by: Scott Schreckengaust [email protected] * fix: add a pre-commit local for npm to run too Signed-off-by: Scott Schreckengaust [email protected] * fix: typo Signed-off-by: Scott Schreckengaust [email protected] * fix: pre-commit issues Signed-off-by: Scott Schreckengaust [email protected] * fix: double copyright Signed-off-by: Scott Schreckengaust [email protected] * fix: double license Signed-off-by: Scott Schreckengaust [email protected] --------- Signed-off-by: Scott Schreckengaust [email protected] Co-authored-by: Alain Krok [email protected]")#510[)](https://github.com/awslabs/mcp/commit/6827ea31fbdef08e648b0c422e4158f913001f59 "feat: fix and check license header automation (#510) * feat: check license header Signed-off-by: Scott Schreckengaust [email protected] * fix: add line break Signed-off-by: Scott Schreckengaust [email protected] * fix: lots of files Signed-off-by: Scott Schreckengaust [email protected] * fix: even more Signed-off-by: Scott Schreckengaust [email protected] * Revert \"fix: add line break\" This reverts commit 122fc210da47b9db4ecf382cd271921f5929cbb8. * feat: check license header configuration Signed-off-by: Scott Schreckengaust [email protected] * fix: cover excluded files from licenses Signed-off-by: Scott Schreckengaust [email protected] * fix: all files to match header Signed-off-by: Scott Schreckengaust [email protected] * fix: add a pre-commit local for npm to run too Signed-off-by: Scott Schreckengaust [email protected] * fix: typo Signed-off-by: Scott Schreckengaust [email protected] * fix: pre-commit issues Signed-off-by: Scott Schreckengaust [email protected] * fix: double copyright Signed-off-by: Scott Schreckengaust [email protected] * fix: double license Signed-off-by: Scott Schreckengaust [email protected] --------- Signed-off-by: Scott Schreckengaust [email protected] Co-authored-by: Alain Krok [email protected]")	Jun 4, 2025
.gitignore	.gitignore	refactor(core-mcp-server): simplify implementation and improve test c… (	Apr 15, 2025
.python-version	.python-version	[Update project to support Python 3.10 and above (](https://github.com/awslabs/mcp/commit/f979d1f832fabcacd83166a292a09a547287735e "Update project to support Python 3.10 and above (#57) * Update project to support Python 3.10 and above - Tested functionality on Python 3.10 and newer version - Aligned project with MCP Python SDK requirements Quality assurance steps: - Ran 'ruff check .' to identify and fix linting issues - Applied 'ruff format .' to ensure consistent code formatting - Executed 'uv run --frozen pyright' for type checking * feat(.ruff.toml): adds shared ruff at the root of the repo\" --------- Co-authored-by: laithalsaadoon [email protected]")#57[)](https://github.com/awslabs/mcp/commit/f979d1f832fabcacd83166a292a09a547287735e "Update project to support Python 3.10 and above (#57) * Update project to support Python 3.10 and above - Tested functionality on Python 3.10 and newer version - Aligned project with MCP Python SDK requirements Quality assurance steps: - Ran 'ruff check .' to identify and fix linting issues - Applied 'ruff format .' to ensure consistent code formatting - Executed 'uv run --frozen pyright' for type checking * feat(.ruff.toml): adds shared ruff at the root of the repo\" --------- Co-authored-by: laithalsaadoon [email protected]")	Apr 2, 2025
CHANGELOG.md	CHANGELOG.md	fix: remove sse from multiple mcp servers (#421)	May 27, 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
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: update core (#906)	Aug 1, 2025
View all files

README.md

Outline

Core MCP Server

MCP server that provides a starting point for using the following awslabs MCP servers

• awslabs.aws-api-mcp-server
• awslabs.cdk-mcp-server
• awslabs.bedrock-kb-retrieval-mcp-server
• awslabs.nova-canvas-mcp-server
• awslabs.aws-pricing-mcp-server
• awslabs.aws-documentation-mcp-server
• awslabs.aws-diagram-mcp-server

Features

Planning and orchestration

• Provides tool for prompt understanding and translation to AWS services

Prerequisites

• Python 3.12 or higher
• uv - Fast Python package installer and resolver
• AWS credentials configured with Bedrock access
• Node.js (for UVX installation support)

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.core-mcp-server": { "command": "uvx", "args": [ "awslabs.core-mcp-server@latest" ], "env": { "FASTMCP_LOG_LEVEL": "ERROR" }, "autoApprove": [], "disabled": false } } } undefined

or docker after a successful docker build -t awslabs/core-mcp-server .:

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

Tools and Resources

The server exposes the following tools through the MCP interface:

• prompt_understanding - Helps to provide guidance and planning support when building AWS Solutions for the given prompt

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.