MCP server for Amazon Q Developer CLI that manages prompt files
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"prompt-mcp-server","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Prompt MCP Server for Amazon Q A single-file Model Context Protocol (MCP) server for Amazon Q Developer CLI that manages prompt files (*.md) from local directories. ## Features - **🔄 Real-time File Monitoring**: Automatically detects file changes and updates prompt list - **📢 MCP Notifications**: Sends notifications to Amazon Q CLI for automatic refresh - **📁 Prompt Discovery**: Lists all `*.md` files from configured directories - **🏠 Default Directory**: `~/.aws/amazonq/prompts` (created automatically) - **🎯 Custom Directories**: Override with `PROMPTS_PATH` environment variable (PATH-like format) - **🔧 Variable Substitution**: Supports `{variable}` placeholders in prompts - **🔍 Configurable Logging**: Production-safe defaults with comprehensive debug mode - **🌐 Cross-Platform**: Works on Unix/Linux/macOS (Windows compatible) - **⚡ Error Handling**: Comprehensive error handling and logging - **📦 No Dependencies**: Pure Python 3.8+ implementation ## Installation & Usage ### Quick Start with uvx (Recommended) ```bash # Install and run directly (after publishing to PyPI) uvx prompt-mcp-server # Or install from local build pyproject-build uvx --from ./dist/prompt_mcp_server-2.0.3-py3-none-any.whl prompt-mcp-server ``` ### Direct Usage ```bash # Run the server directly python3 mcp_server/prompt_mcp_server.py # With custom prompt directories PROMPTS_PATH="./my-prompts:~/.aws/amazonq/prompts" python3 mcp_server/prompt_mcp_server.py ``` ### Amazon Q Integration ```bash # The workspace is configured to use uvx with the built package q mcp list # Verify configuration (should show: prompt-server uvx) q chat # Start Amazon Q CLI /prompts # List available prompts @debug_code # Use a prompt ``` **Configuration files:** - `.amazonq/mcp.json` - Uses local development path - `tests/.amazonq/mcp.json` - Uses local built package - `tests/.amazonq/mcp-published.json` - For publis…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.