HatmanStack/ragstack-mcp

QUESTIONS?
Features
- ☁️ Fully serverless architecture (Lambda, Step Functions, S3, DynamoDB)
- 🧠 **NEW** Amazon Nova multimodal embeddings for text and image vectorization
- 📄 Document processing & vectorization (PDF, images, Office docs, HTML, CSV, JSON, XML, EML, EPUB) → stored in managed knowledge base
- 🎬 **NEW** Video/audio processing - transcribe speech with AWS Transcribe, searchable by timestamp
- 💬 AI chat with retrieval-augmented context and source attribution
- 📎 Collapsible source citations with optional document downloads
- ⏱️ **NEW** Media sources with timestamp links - click to play at exact position
- 🔍 Metadata filtering - auto-discover document metadata and filter search results
- 🎯 Relevancy boost for filtered results - prioritize matches from metadata filters
- 🔄 Knowledge Base reindex - regenerate metadata for existing documents with updated settings
- 🗑️ Document management - reprocess, reindex, or delete documents from the dashboard
- 🌐 Web component for any framework (React, Vue, Angular, Svelte)
- 🚀 One-click deploy
- 💰 $7-10/month (1000 docs, Textract + Haiku)
Live Demo
| Environment | URL | Credentials |
|-------------|-----|-------------|
| **Base Pipeline** | dhrmkxyt1t9pb.cloudfront.net | guest@hatstack.fun / Guest@123 |
| **Project Showcase** | showcase-htt.hatstack.fun | Login as guest |
> **Base Pipeline**: The core document processing tool - upload, OCR, and query documents.
>
> **Project Showcase**: See RAGStack powering a real application.
Quick Start
Option 1: One-Click Deploy (AWS Marketplace)
**REPO IS IN ACTIVE DEVELOPMENT AND WILL CHANGE OFTEN**
Deploy directly from the AWS Console - no local setup required:
1. Subscribe to RAGStack on AWS Marketplace (free, not required - If subscribed Lambda roles auto-accept Bedrock model agreements on first invocation)
2. Click here to deploy
3. Enter a stack name (**lowercase only**, e.g., "my-docs") and your admin email
4. Click **Create Stack** (deployment takes ~10 minutes)
**After deployment:**
- Check your email for the temporary password (from Cognito)
- Go to CloudFormation → your stack → **Outputs** tab to find the Dashboard URL (UIUrl)
Option 2: Deploy from Source
For customization or development:
**Prerequisites:**
- AWS Account with admin access
- Python 3.13+, Node.js 24+
- uv (Python package manager)
- AWS CLI, SAM CLI (configured)
- Docker (for Lambda layer builds)
Option 3: Nested Stack Deployment
Deploy RAGStack as part of a larger CloudFormation stack. See Nested Stack Deployment Guide for details.
**Quick example:**
Web Component Integration
See RAGSTACK_CHAT.md for web component integration guide.
API Access
**Server-side integrations** use API key authentication. Get your key from Dashboard → Settings.
**Web component** uses IAM auth (no API key needed - handled automatically).
Each UI tab shows server-side API examples in an expandable section.
MCP Server (AI Assistant Integration)
Use your knowledge base directly in Claude Desktop, Cursor, VS Code, Amazon Q CLI, and other MCP-compatible tools.
Add to your AI assistant's MCP config:
Then ask naturally: *"Search my knowledge base for authentication docs"*
See MCP Server docs for full setup instructions.