MCP Server Test 02

🚀 Popmelt Model Context Protocol (MCP) User Guide

Popmelt MCP is a reference implementation for creating deeply personalized AI interactions through complex taste profiles. This project sets a framework for the next generation of AI personalization, maintaining consistent design and interaction patterns.

🚀 Quick Start

Prerequisites

• Node.js version 18 or higher
• PostgreSQL database

Installation

1. Clone the repository:

git clone https://github.com/popmelt/mcp.git
cd mcp

2. Install dependencies:

npm install

3. Configure environment variables:

cp .env.example .env
# Edit the database connection string and other settings in the .env file as needed

4. Run Prisma migrations:

npx prisma migrate dev

5. Start the development server:

npm run dev

✨ Features

• Profile Management: Achieve personalized interactions through taste profiles.
• Dynamic Context Processing: Adjust response styles and behaviors in real-time.
• Modular Design System: Support flexible design components and variants.
• Efficient State Management: Control states using the React Context API and Zustand.

📚 Documentation

Core Concepts

Taste Profiles

Taste profiles are at the core of the Popmelt ecosystem, achieved through multi - dimensional personalization:

• Style Vectors: Multi - dimensional representation of AI personality traits.
• Context Weighting: Prioritize different context sources.
• Response Mapping Rules: Define context - based response styles.
• Design System: Visual styles and component variants.

Model Context Protocol

MCP sets a standardized approach to manage context:

• Bidirectional Context Flow: Handle bidirectional context in a complex manner.
• Hierarchical Context Prioritization: Organize context in multiple levels and define clear weights.
• Context Conflict Resolution: Methods to handle contradictions from different context sources.
• Profile - Aware Context Processing: Adjust context based on the active taste profile.

Dynamic Design System

This design system provides real - time styles based on taste profiles:

• Response Templates: A mechanism for dynamically applying design patterns.
• Visual Semantic Alignment: Mapping between meaning and presentation.
• Dynamic Typography: Content - aware font adjustment.
• Interaction Patterns: A curated collection of interaction models.

🔧 Technical Details

Core Technologies

• Front - end: Next.js 14+ combined with App Router.
• Programming Language: TypeScript 5.0+.
• State Management: React Context API + Zustand 4.4+.
• Style Sheets: Tailwind CSS 3.4+ with custom design tokens.
• API Layer: tRPC 10+ for end - to - end type - safe APIs.
• Database: Prisma ORM with PostgreSQL.
• Authentication: NextAuth.js/Auth.js combined with JWT.
• Testing: Vitest, React Testing Library, and Playwright.

Project Structure

/src
  /app                   # Next.js App Router pages
  /components            # React components
  /lib                   # Core application logic
  /pages                 # Page components
  /public                # Static resource folder
  /styles                # Style folder

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgments

Thanks to all contributors and supporters who made Popmelt MCP possible.