Popmelt 模型上下文协议 (MCP)

Popmelt MCP 是一个参考实现，旨在通过复杂的品味配置文件创建深度个性化的 AI 交互。该项目建立了一个框架，用于实现下一代 AI 个性化，并保持一致的设计和交互模式。

核心概念

品味配置文件

品味配置文件是 Popmelt 生态系统的基石，通过以下方式提供多维度的个性化：

• 风格向量: AI 人格特征的多维表示
• 上下文权重: 不同上下文来源的优先级排序
• 响应映射: 基于上下文设置响应样式的规则
• 设计系统: 视觉样式和组件变体

模型上下文协议

MCP 建立了管理上下文的标准化方法：

• 双向上下文流: 复杂地处理双向上下文
• 分层上下文优先级: 具有显式权重的多层上下文组织
• 上下文冲突解决: 解决上下文来源之间冲突的方法
• 配置文件感知上下文处理: 适应活动品味配置文件的上下文处理

动态设计系统

设计系统根据品味配置文件提供实时样式：

• 响应模板: 动态应用设计模式的系统
• 视觉-语义对齐: 意义和呈现之间的映射
• 动态排版: 内容感知的排版调整
• 交互模式: 精选的交互模型集合

快速开始

前提条件

• Node.js 18+
• PostgreSQL

安装

1. 克隆仓库:

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

2. 安装依赖:

   npm install
   

3. 配置环境变量:

   cp .env.example .env
   # 编辑 .env 文件，填入你的数据库连接字符串和其他设置
   

4. 运行 Prisma 迁移:

   npx prisma migrate dev
   

5. 启动开发服务器:

   npm run dev
   

技术架构

核心技术

• 前端: Next.js 14+ with App Router
• 语言: TypeScript 5.0+
• 状态管理: React Context API + Zustand 4.4+
• 样式: Tailwind CSS 3.4+ with custom design tokens
• API 层: tRPC 10+ for end-to-end typesafe APIs
• 数据库: Prisma ORM with PostgreSQL
• 认证: NextAuth.js/Auth.js with JWT
• 测试: Vitest, React Testing Library, and Playwright

项目结构

/src
  /app                   # Next.js App Router 页面
  /components            # React 组件
  /lib                   # 核心应用逻辑
  /server                # 服务器端代码
  /types                 # TypeScript 类型定义
  /utils                 # 实用函数
  /hooks                 # 自定义 React hooks
  /contexts              # React Context 提供者
/prisma                  # Prisma schema 和迁移

主要特性

1. 配置文件创建 & 管理

   • 带有模板的配置文件创建向导
   • 带有实时预览的视觉配置文件编辑器

2. 上下文管理系统

   • 从多个来源收集上下文
   • 配置文件感知的上下文优先级排序

3. 交互式设计系统

   • 实时设计令牌操作
   • 组件变体预览

4. 模型集成框架

   • 支持多个 LLM 提供商
   • 自定义指令模板

5. 分析仪表板

   • 配置文件性能指标
   • 交互成功率

许可证

该项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

致谢

• 该项目是 Popmelt 生态系统的一部分，用于个性化 AI 交互。

了解更多

要了解有关 Next.js 的更多信息，请查看以下资源：

• Next.js 文档 - 了解有关 Next.js 功能和 API 的信息。
• 学习 Next.js - 一个交互式的 Next.js 教程。

您可以查看 Next.js GitHub 仓库 - 欢迎您的反馈和贡献！

部署到 Vercel

部署 Next.js 应用程序的最简单方法是使用 Next.js 创建者的 Vercel 平台。

请查看我们的 Next.js 部署文档 了解更多详情。