How sparesparrow/mcp-prompts works
• MCP Prompts Server – This is the core service which handles API requests, prompt management (CRUD operations, variable substitution/template processing), and SSE events.
○ File Storage (JSON files on disk)
○ PostgreSQL Adapter (database-driven storage, including vector search aspects)
○ MDC Adapter (managing prompts in Cursor Rules Marker Down Code (.mdc) files)
• Template and Prompt Processing – A module (or set of modules) inside the MCP Prompts Server that is responsible for converting prompt formats, variable extraction, and applying templates.
• External Interfaces:
○ API/SSE Endpoint – Representing how clients (e.g., Claude Desktop or AI Clients) interact via HTTP and SSE.
○ Docker Deployment Components – Containers running for different environments (development, production, testing) with docker-compose and management scripts.
• CI/CD and Development Tools – Optionally include the GitHub workflows, Dockerfiles, test directories, and scripts that drive the build, test, release, and deployment flows.
Relationships and Interactions
• That Docker Compose deployments act as an orchestration mechanism, connecting various containers (the prompts container, PostgreSQL, and integration service containers) via a network, with volumes for persistence.
Architectural Patterns and Key Design Principles
• A modular, layered design where the core MCP Prompts Server is decoupled from storage specifics (via the adapter pattern) and from external integrations (using resource routing or integration service patterns).
• That the design supports multiple configurations (e.g., file-based vs. PostgreSQL vs. MDC storage) determined at runtime by environment variables.
• Use deployment patterns with Docker and CI/CD workflows – which help in iterative delivery, testing (unit and integration tests), and versioning/release pipelines.
• Acknowledge the use of SSE (for low-latency updates) and a clear separation of concerns between prompt management, template transformation, and external service integration.