An MCP (Model Context Provider) server that provides comprehensive access to AWS Amplify Gen 2 Next.js documentation, enabling AI assistants to provide accurate, up-to-date guidance on building applications with Amplify.
Key Features
MCP server for AWS Amplify Gen 2 documentation - enables smart search, pattern discovery, and indexing of Amplify docs
2026-10-28
Estrelas
4
Ferramentas
—
Disponibilidade
—
Accurate Category Search: All 10 documentation categories are searchable (api-data, authentication, backend, deployment, frontend, general, getting-started, reference, storage, troubleshooting)
Enhanced Amplify Data Search: Specialized search optimization for Amplify's primary data solution (defineData, a.model, real-time subscriptions)
Correct Pattern Matching: API patterns return REST/HTTP API content, while Data patterns return Amplify Data content
CRUD Form Generation: Complete documentation for Amplify's automatic form generation feature
Clear Architecture Understanding: Distinguishes between core services (Auth, Data, Storage) and additional AWS services
Helpful Error Messages: Invalid categories show available options instead of generic errors
SQLite Storage: Efficient local storage with full-text search capabilities
Markdown Conversion: HTML documentation is converted to clean markdown format
Installation
Prerequisites
Python 3.12 or higher
uv (Python package manager): curl -LsSf https://astral.sh/uv/install.sh | sh
Claude Desktop and/or Claude Code installed
Version Compatibility
AWS Amplify Gen 2 is compatible with:
Next.js: 14.x or 15.x (both App Router and Pages Router)
TypeScript: 5.0 or higher (optional but recommended)
Node.js: 18.x or higher
Use uv run python amplify_cli.py check-versions to verify compatibility.
Getting Started with Compatible Versions
⚠️ IMPORTANT: Manual package installation often leads to version conflicts!
For a new project with guaranteed compatible versions:
Use Amplify's Next.js starter template (STRONGLY recommended):
npx create-amplify@latest --template nextjs
Or equivalently:
npm create amplify@latest --template nextjs
This creates a complete Next.js project with ALL compatible versions pre-configured.
Why manual installation is problematic:
Running npm create amplify@latest followed by npm install next react react-dom often causes dependency conflicts
Amplify packages have specific peer dependency requirements
Version mismatches can lead to ERESOLVE warnings and runtime issues
If you must use an existing Next.js project:
Ensure Next.js is version 14.x or 15.x
Run npm create amplify@latest
Install the exact versions that match your Amplify packages
Be prepared to resolve dependency conflicts
Verify compatibility:
uv run python amplify_cli.py check-versions
Quick Installation
# Clone the repository
git clone https://github.com/your-username/amplify-gen-2-nextjs-docs.git
cd amplify-gen-2-nextjs-docs
# Install all dependencies automatically (like npm install)
uv sync
# Initialize the documentation database
uv run python amplify_docs_server.py
# Press Ctrl+C after it starts successfully
Note: uv sync automatically installs all dependencies from pyproject.toml - no manual package installation needed!
data - Amplify Data patterns (defineData, a.model, real-time)
api - REST/HTTP API patterns (API Gateway, custom endpoints)
storage - File operations (S3 integration)
deployment - CI/CD patterns
configuration - amplify/backend.ts patterns
database - Advanced DynamoDB patterns
functions - Lambda functions
ui - UI building patterns (CRUD forms, components)
ssr - Server-side rendering patterns
typescript - TypeScript-first patterns
workflow - Development workflows
Example:
Find patterns for "auth"
7. getCreateCommand
Get the CORRECT command for creating a new Amplify Gen 2 + Next.js application.
Example:
Get the correct create command
8. getQuickStartPatterns
Get ready-to-use code patterns for common Amplify tasks.
Parameters:
task (string, required): The task you want to accomplish
Available Tasks:
create-app - Create new Amplify + Next.js application
add-auth - Add authentication to your app
add-api - Add GraphQL API with data models
add-storage - Configure file storage
file-upload - Implement file upload functionality
crud-forms - Generate automatic CRUD forms from data models
user-profile - User profile management
real-time-data - Real-time data synchronization
deploy-app - Deploy your application
custom-auth-ui - Custom authentication UI
data-relationships - Data relationships and queries
Example:
Get quick start pattern for "add-auth"
Usage Examples
Initial Setup
First, fetch the latest documentation:
Use the fetchLatestDocs tool to index Amplify documentation
Check the statistics:
Use getStats to see how many documents were indexed
Searching for Information
Search for "cognito authentication" using searchDocs
Finding Code Examples
Use findPatterns with pattern_type "auth" to find authentication examples
Getting Specific Documentation
Use getDocument with url "https://docs.amplify.aws/nextjs/build-a-backend/data/"
Running the Server
Standalone Mode
uv run python amplify_docs_server.py
Using the Shell Script
./run_server.sh
Command Line Interface (CLI)
The project includes a CLI tool (amplify_cli.py) for direct interaction with the documentation database without running the MCP server.
Automatic Update Reminders
The CLI automatically checks if your documentation is outdated (more than 30 days old) when you run any command except fetch. If an update is needed, you'll be prompted to update. If you decline, the system will wait at least 24 hours before asking again.
--category: Filter by category (backend, frontend, etc.)
--limit: Maximum number of results (default: 10)
List Categories
uv run python amplify_cli.py categories
Show Statistics
uv run python amplify_cli.py stats
Find Patterns
uv run python amplify_cli.py patterns TYPE
Where TYPE is one of: auth, api, storage, deployment, configuration, database, functions
CLI Examples
# Fetch all available documentation
uv run python amplify_cli.py fetch
# Force refresh all documents
uv run python amplify_cli.py fetch --force
# Fetch with markdown export
uv run python amplify_cli.py fetch --save-markdown
# Search for authentication docs
uv run python amplify_cli.py search "cognito authentication" --category backend
# Get full document content
uv run python amplify_cli.py get-document "https://docs.amplify.aws/nextjs/..."
# Show database statistics
uv run python amplify_cli.py stats
# Find auth patterns
uv run python amplify_cli.py patterns auth
# List all categories
uv run python amplify_cli.py categories
# Export all documents to markdown files
uv run python amplify_cli.py export-markdown
# Check version compatibility
uv run python amplify_cli.py check-versions
Database
The server uses SQLite to store documentation locally. The database file amplify_docs.db is created in the same directory as the server.
Database Schema
documents table:
url (unique identifier)
title
content (raw text)
markdown_content
category
last_scraped
embedding_vector (reserved for future use)
scrape_metadata table:
Tracks scraping sessions and status
Development
Testing the Server
Use the included test script:
uv run python test_server.py
Logging
The server uses Python's logging module. Set the log level in the code:
logging.basicConfig(level=logging.INFO)
Update Tracking
The CLI tracks documentation updates in a last_updated.json file (automatically created on first use). This file contains:
last_updated: When documentation was last fetched
last_prompted: When the user was last asked about updates
user_declined: Whether the user declined the last update prompt
This file is gitignored and local to each installation.
Troubleshooting
Version Conflicts (ERESOLVE warnings)
If you see npm warnings about peer dependencies after manual installation:
Solution: Use npx create-amplify@latest --template nextjs instead
These warnings indicate incompatible package versions
Manual installation of React/Next.js after npx create-amplify often causes conflicts
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Amplify Docs?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Amplify Docs precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Amplify Docs usa?
Amplify Docs roda localmente via stdio.
Quando Amplify Docs foi verificado pela última vez?
Última verificação: 2026-10-28. MCP server for AWS Amplify Gen 2 documentation - enables smart search, pattern discovery, and indexing of Amplify docs