This MCP server provides access to AWS Amplify Gen 2 documentation for Next.js projects. It indexes documentation across multiple categories (getting-started, backend, frontend, deployment, authentication, api-data, reference, storage, general, troubleshooting) and exposes tools to search, overview, and retrieve documents, as well as find common patterns and generate quick-start patterns. Use the available tools to fetch a documentation overview, search by query and category, retrieve specific documents by URL, list categories, view statistics, and discover recurring patterns for authentication, data models, APIs, and more. The server is built around the MCP Python SDK and stores indexed content locally for fast full-text search with Markdown conversion for easy reading.

Key capabilities include:

• getDocumentationOverview: obtain a summary or full overview of all documentation.
• searchDocs: query indexed docs with optional category filtering and result limits.
• getDocument: fetch a specific document by its URL.
• listCategories: discover all available documentation categories.
• getStats: view indexing and usage statistics.
• findPatterns: locate common amplification patterns (auth, data, API, storage, deployment, etc.).
• getCreateCommand and getQuickStartPatterns: obtain recommended commands and ready-to-use code patterns for common Amplify tasks.

To use these tools, run requests against the MCP server via Claude Desktop or Claude Code (or any MCP client). Ensure the server is running with uv (as shown in the installation setup). The tools will respond with structured data or markdown-formatted documentation suitable for AI-assisted guidance.

Prerequisites:

• Python 3.12 or higher
• uv (Python package manager): install via the provided uv install script
• Claude Desktop and/or Claude Code installed (optional but recommended for MCP usage)

Step-by-step installation:

1. Install uv (Python package manager): curl -LsSf https://astral.sh/uv/install.sh | sh

2. Install and set up the MCP Python SDK dependencies for the server (as applicable in your project): uv sync

3. Ensure you have the Amplify Gen 2 Next.js documentation source ready for indexing. The server will scrape and index the content locally.

4. Start the documentation server: uv run python amplify_docs_server.py

   Press Ctrl+C after it starts successfully

5. Optional: verify compatibility between Amplify Gen 2 and your environment: uv run python amplify_cli.py check-versions

Configuration in Claude (example):

• Claude Desktop should point to the MCP server with the following configuration: { "mcpServers": { "amplify-docs": { "command": "uv", "args": ["run", "python", "/full/path/to/amplify_docs_server.py"], "env": {} } } }

Notes:

• The uv sync command will install dependencies from pyproject.toml automatically.
• Use a compatible Node/Next.js environment if you plan to cross-check with Amplify’s templates.

Tips and common issues:

• Ensure Python 3.12+ is active in your environment before starting the server.
• If you encounter dependency issues, prefer using Amplify’s Next.js starter templates to align compatible versions.
• When configuring Claude, ensure the full path to amplify_docs_server.py is correct in the command arguments.
• The server stores data locally (SQLite); monitor disk usage if indexing large documentation sets.
• If categories or patterns aren’t appearing as expected, re-run indexing or verify the source documentation is up to date.
• Use the getStats tool to monitor indexing progress and results over time.