AWS Labs Frontend MCP Server

1.0.13 verified Fri May 01 auth: no python

An AWS Labs Model Context Protocol (MCP) server for frontend development. Enables AI assistants to interact with AWS frontend services via the MCP protocol. Current version 1.0.13, actively maintained with regular releases.

pip install awslabs-frontend-mcp-server

Common errors

error ModuleNotFoundError: No module named 'awslabs_frontend_mcp_server' ↓

cause Attempting to import using hyphens instead of underscores.

fix

Install package: pip install awslabs-frontend-mcp-server, then import: from awslabs_frontend_mcp_server import FrontendMCPServer

error ValueError: AWS credentials not found. Please configure AWS access keys. ↓

cause AWS credentials not provided via environment variables or constructor arguments.

fix

Set AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY in environment or pass to FrontendMCPServer constructor.

error TypeError: __init__() got an unexpected keyword argument 'region' ↓

cause Using incorrect parameter name. The correct parameter is 'region_name'.

fix

Use region_name='us-east-1' instead of region='us-east-1'.

Warnings

gotcha The package name on PyPI uses hyphens (awslabs-frontend-mcp-server) but the import uses underscores (awslabs_frontend_mcp_server). Common mistake leads to ImportError. ↓

fix Use `from awslabs_frontend_mcp_server import ...` with underscores.

deprecated Support for Python 3.9 and below was dropped. Requires Python >=3.10. ↓

fix Upgrade to Python 3.10 or later.

gotcha AWS credentials must be provided either via environment variables or explicitly. The server will fail at runtime if not configured. ↓

fix Set AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_DEFAULT_REGION environment variables, or pass them to the constructor.

Imports

FrontendMCPServer

wrong

from awslabs.frontend_mcp_server import FrontendMCPServer

correct

from awslabs_frontend_mcp_server import FrontendMCPServer

Actual package name uses underscores, not hyphens

Quickstart

Initializes and starts the frontend MCP server with AWS credentials.

import os
from awslabs_frontend_mcp_server import FrontendMCPServer

aws_access_key = os.environ.get('AWS_ACCESS_KEY_ID', '')
aws_secret_key = os.environ.get('AWS_SECRET_ACCESS_KEY', '')
region = os.environ.get('AWS_DEFAULT_REGION', 'us-east-1')

server = FrontendMCPServer(
    aws_access_key_id=aws_access_key,
    aws_secret_access_key=aws_secret_key,
    region_name=region
)
# Start server (implementation-specific, may use server.run() or similar)
# server.run()