MCP-1st-Birthday/DreamWeaver-AI-Dream-Analysis-and-Interpretation
๐ DreamWeaver AI: Unlock Your Subconscious Mind
๐ค Track 2: MCP in Action Submission (Creative Applications)
DreamWeaver AI acts as a personal, persistent dream interpreter. It uses an autonomous Agentic framework to plan, reason, and execute complex dream analysis tasks, storing and retrieving data to provide contextual interpretations over time.
๐ Judging Criteria & Feature Highlights
This project addresses the core requirements and bonus criteria for the MCP in Action track:
1. Agentic Behavior & Functionality
The core Agent demonstrates the full planning and execution loop:
- Planning: The agent identifies key symbols in the user's dream (e.g., "flying," "chasing," "water").
- Reasoning: It queries the persistent memory (journal history) for recurring symbols and themes to provide a contextually relevant interpretation.
- Execution: It uses the Anthropic Claude API (via MCP servers) as the primary tool to generate a sophisticated, poetic analysis.
- Gradio 6: The application is built entirely on Gradio 6.0.0, utilizing its advanced components for a clear, intuitive UI-UX, including collapsible journal entries for easy review.
2. Advanced Agent Features (Bonus ๐ )
- Context Engineering / RAG: We utilize the user's journal history (
history_list) as a form of Retrieval-Augmented Generation (RAG). This memory is injected into the prompt for the current dream, ensuring the analysis is personal and references past thematic patterns (e.g., "Your recurring flight dreams suggest an ongoing quest for liberation..."). - Persistent Memory: Journal entries are persisted and displayed, giving the agent a valuable context window for long-term thematic analysis.
๐ป Technical Implementation Details
- SDK: Gradio 6.0.0 (Python)
- Agent Tool: Anthropic Claude (via MCP)
- Data Structure: The dream journal is managed in a Python list of dictionaries. The display uses custom string formatting to convert Markdown-style analysis output into clean, styled HTML (utilizing
<h3>,<h4>,<p>, etc.) for polished rendering within the Gradio interface.
๐ฅ Demo Video & Social Media
โ ๏ธ CRITICAL SERVICE ALERT: LIMITED FUNCTIONALITY IMMINENT
The DreamWeaver AI's deep analysis engine is powered by the Anthropic Claude API via a time-sensitive hackathon credit. The core dream interpretation and analysis feature will cease to function shortly upon credit expiration. Thank you for testing the application during this limited demonstration window. The journaling and UI features will remain available.
