Dam Butler MCP

🚀 🤖 DAM Butler MCP

DAM Butler MCP 是一款革命性的模型，它借助自然语言和人工智能，改变了团队查找品牌资产的方式，为 Breville 的 Vault DAM 系统提供基于意图的数字资产发现功能。

🌐 在线部署地址： https://dam-butler-mcp.vercel.app/

🚀 快速开始

团队成员快速上手

1. 访问自定义 GPT

1. 打开 ChatGPT Enterprise。
2. 在自定义 GPT 中找到 “Breville Vault Assistant”。
3. 开始使用自然语言进行搜索！

2. 查询示例

💬 "查找用于我演示文稿的带有透明背景的 Oracle Jet 产品照片"
💬 "获取面向英国市场的 Sage BES985 产品照片"
💬 "给我展示用于社交媒体的 Oracle 双锅炉生活方式照片"
💬 "我需要澳大利亚买家指南资产"
💬 "查找用于电子邮件营销活动的 PNG 格式的 Breville 标志"
💬 "我需要澳大利亚版的 BES881 手册"

3. 专业提示

• 明确使用场景：例如 “用于演示文稿”、“用于网页”、“用于印刷”。
• 提及相关地区：例如 “面向英国市场”、“澳大利亚版”。
• 指定格式需求：例如 “透明背景”、“高分辨率”。

✨ 主要特性

🧠 三层 AI 智能（第三阶段）

• 🤖 OpenAI 增强：定制的 Breville 提示，置信度达 95% 以上。
• 👁️ GPT - 4 视觉：视觉相似性搜索和图像分析。
• 🏢 Vault 智能：基于 14 个部分和 80 多个可交付成果进行训练。
• 🔄 三重回退机制：OpenAI → 增强模式 → 基本模式（100% 可靠性）。

🌍 区域领域智能

• 亚太/美国市场领域：Breville 品牌（BES 型号）。
• 欧洲、中东和非洲市场领域：Sage 品牌（SES 型号）。
• 自动检测：区域上下文和品牌切换。
• 📊 使用分析：特定领域的性能跟踪。

📁 资产类型掌控

• 标志：品牌标识、产品标志、矢量格式。
• 产品摄影：特写照片、技术照片、360° 视图。
• 生活方式摄影：使用中的图像、情境照片。
• 营销材料：营销活动资产、社交媒体内容、横幅。
• 文档：买家指南、手册、规格表。

🎨 使用场景优化

• 演示文稿：高分辨率 PNG/SVG 格式，支持透明背景。
• 网页：优化格式，响应式尺寸。
• 印刷：CMYK 模式、矢量格式、高 DPI。
• 社交媒体：特定平台尺寸，注重互动性。
• 电子邮件：适合电子邮件的格式，轻量级文件。

📦 安装指南

此部分原文档未提供安装步骤，暂不展示安装指南相关内容。

💻 使用示例

基础用法

// 输入
{
  "request": "Oracle Jet logo for my presentation",
  "context": {
    "user_region": "AU",
    "campaign_type": "product_launch", 
    "urgency": "high"
  }
}

// MCP 输出（ChatGPT Enterprise）
{
  "content": [
    {
      "type": "text", 
      "text": "🎯 Found 1 asset for \"Oracle Jet logo for my presentation\"\n\n📋 **Detected**: Oracle Jet | logo | presentation\n\n**1. Oracle Jet Logo - Primary**\n📁 Format: PNG | Size: 2048x1024\n🔗 Download: https://vault.breville.com/download/...\n💡 Oracle Jet Logo in PNG format with transparency. Perfect for presentation use.\n   ✅ PNG format ideal for presentations\n   ✅ High resolution, suitable for print\n   ✅ Transparent background supported\n\n💡 **Suggestions**:\n• For web use, consider WebP format for faster loading\n• SVG version available for infinite scalability"
    }
  ]
}

// 原始 API 输出
{
  "success": true,
  "intent": {
    "products": [{"name": "Oracle Jet", "model": "BES985", "confidence": 0.95}],
    "assetTypes": ["logo"],
    "useCase": "presentation", 
    "formats": ["PNG", "SVG"],
    "region": "global",
    "confidence": 0.95,
    "source": "openai",
    "reasoning": "User wants Oracle Jet logo for presentation, suggesting PNG/SVG for transparency"
  },
  "results": [...],
  "suggestions": [...]
}

📚 详细文档

🎯 什么是 DAM Butler？

DAM Butler 是一个 革命性的 MCP（模型上下文协议）服务器，它将 ChatGPT Enterprise 与 Breville 的 Vault DAM 系统连接起来。它无需用户进行复杂的搜索和筛选，而是理解自然语言请求，并准确提供他们所需的内容。

🔥 神奇之处

❌ 旧方法：“搜索资产” → “按 Oracle Jet 过滤” → “按标志过滤” → “查看 47 个结果”
✅ DAM Butler：“我演示文稿需要的 Oracle Jet 标志” → 30 秒内找到 3 个完美匹配项

真实用户反馈：“这感觉就像魔法！我只需要说出我需要的东西，它就能找到。”

🏗️ 架构：基于意图与 API 包装器

🚫 为什么大多数 DAM 集成会失败

大多数公司构建简单的 API 包装器，存在以下问题：

• 迫使 AI 为简单请求进行 4 次以上的 API 调用。
• 返回如 “404 Not Found” 这样的隐晦错误。
• 提供无关数据，浪费令牌。
• 给用户带来糟糕的体验。

✅ 我们基于意图的方法

用户请求 → 意图解析器 → 智能编排器 → 完美结果
     ↓              ↓               ↓                    ↓
"Oracle Jet   产品=BES985   增强搜索    3 个完美匹配项
照片用于      格式=PNG       + 上下文      + 使用说明
演示文稿" 用例=演示文稿  + 品牌映射    + 下载链接

关键创新：单个 MCP 调用通过内置智能处理完整工作流程。

🔧 API 参考

增强型 MCP 端点

🌐 MCP URL：https://dam-butler-mcp.vercel.app/api/mcp
🏥 健康检查：https://dam-butler-mcp.vercel.app/api/health  
📋 架构：https://dam-butler-mcp.vercel.app/api/schema

快速状态检查

# 检查系统健康和配置
curl https://dam-butler-mcp.vercel.app/api/health

# 获取 ChatGPT Enterprise 的 MCP 功能
curl https://dam-butler-mcp.vercel.app/api/mcp

主要搜索工具：find_brand_assets

此部分代码示例已在使用示例中展示。

📊 当前状态：第三阶段企业平台

🌐 在线部署

https://dam-butler-mcp.vercel.app/

✅ 第三阶段企业平台 - 完全运行

• [x] 🎛️ 实时分析仪表板 - 企业级监控，30 秒刷新一次。
• [x] 🔗 生产环境 Brandfolder 集成 - OAuth 准备好立即激活。
• [x] 🧠 带有 GPT - 4 视觉的高级 AI - 视觉相似性搜索和预测性推荐。
• [x] 📊 企业可观测性 - 性能指标、使用分析、区域洞察。
• [x] 🔄 三重回退架构 - OpenAI → 增强模式 → 基本模式（100% 可靠性）。
• [x] 👁️ 视觉智能 - “查找与此图像相似的资产” 功能。
• [x] 🎯 预测性推荐 - 基于 AI 的批量操作和优化。
• [x] 🌍 区域领域智能 - 亚太/美国市场（Breville）与欧洲、中东和非洲市场（Sage）识别。
• [x] 📈 使用分析 - 产品受欢迎程度、解析方法有效性、响应时间。
• [x] 🛡️ 企业级错误处理 - 优雅降级，详细监控。

⏳ 等待事项

• [ ] Brandfolder OAuth 凭证（应用程序审批中）→ 实时资产下载。
• [ ] 在此之前：具有复杂 Vault 智能的 智能演示模式。

🆕 第三阶段新增主要功能

• 📊 企业分析平台（241 行） - 实时监控仪表板。
• 🔗 生产环境 OAuth 集成（350 行） - 准备好立即激活 Brandfolder。
• 🧠 高级 AI 功能（459 行） - GPT - 4 视觉 + 预测性推荐。
• 🎛️ 实时仪表板（521 行） - 基于 React 的监控界面。
• 🧪 全面测试套件（436 行） - 完成第三阶段验证。
• 🗂️ 专业版本控制 - 旧版本组织和部署策略。

📈 平台演进

• 第一阶段：基本模式匹配工具。
• 第二阶段：集成 OpenAI 智能。
• 第三阶段：完整的企业级 DAM 智能平台。

🏢 代码库总量

2000 多行企业级功能代码。

📋 路线图 - 更新

• [x] 视觉相似性搜索 → ✅ 在第三阶段 C 完成（GPT - 4 视觉集成）。
• [x] 智能资产推荐 → ✅ 在第三阶段 C 完成（预测性 AI）。
• [x] 使用 AI 视觉自动标记 → ✅ 在第三阶段 C 完成（高级智能）。
• [ ] Brandfolder OAuth 激活 → 等待凭证。
• [ ] 高级分析导出 → 为企业团队提供 CSV/PDF 报告。
• [ ] 多语言支持 → 拓展国际市场。
• [ ] 批量操作支持 → 一次下载多个资产。
• [ ] 高级访问控制 → 基于团队的权限设置。
• [ ] 资产版本控制 → 跟踪更新和更改。

🚨 故障排除

常见问题

❌ “需要身份验证”（Brandfolder）

• 原因：Brandfolder OAuth 凭证待审批。
• 当前状态：系统在智能演示模式下工作，提供模拟结果。
• 解决方案：等待 Brandfolder 批准 OAuth 应用程序。

✅ “OpenAI 集成正常工作”

• 状态：✅ 已配置，置信度达 95%。
• 功能：高级意图解析、上下文感知、智能推荐。
• 回退机制：当 OpenAI 不可用时，采用智能模式匹配。

❌ “未找到资产”

• 原因：搜索词过于具体或产品名称有变体。
• 解决方案：尝试使用型号代码（如 BES985）、更宽泛的术语（如 “Oracle Jet”）或检查拼写。
• 专业提示：当搜索不匹配时，系统会提供智能建议。

获取帮助

1. 检查健康端点：https://dam-butler-mcp.vercel.app/health。
2. 在 Vercel 仪表板中 查看日志。
3. 使用基本查询进行 测试，如 “Oracle Jet 标志”。
4. 如有资产访问问题，联系 DAM 团队。

🏢 企业功能

访问控制

• 继承 Brandfolder 权限：用户只能看到他们有权限访问的资产。
• 基于区域的限制：买家指南按市场限制访问。
• 团队使用跟踪：按部门和营销活动进行分析。

性能与可靠性

• 全球 CDN：全球快速响应时间。
• 99.9% 正常运行时间：Vercel 企业级托管。
• 智能缓存：减少 API 调用，加快响应速度。
• 优雅降级：回退系统确保始终正常工作。

监控与分析

• 实时健康检查：即时通知问题。
• 使用分析：跟踪热门搜索和资产。
• 性能指标：响应时间和成功率。
• 错误日志记录：详细的调试信息。

🤝 贡献指南

开发工作流程

1. 分叉仓库。
2. 创建功能分支：git checkout -b feature/amazing-feature。
3. 进行更改 并在本地测试：npm run dev。
4. 测试更改：node test-mcp.js。
5. 提交更改：git commit -m 'Add amazing feature'。
6. 推送到分支：git push origin feature/amazing-feature。
7. 打开拉取请求。

代码标准

• ESLint：使用提供的配置。
• 注释：记录复杂的意图解析逻辑。
• 测试：所有新功能必须包含测试。
• 环境：切勿提交 .env 文件或机密信息。

部署

• 自动部署：推送到 main 分支会自动部署到生产环境。
• 环境变量：在 Vercel 仪表板中设置，而不是在代码中。
• 测试：合并前始终在开发环境中测试。

🔧 技术细节

本地开发设置

# 克隆仓库
git clone https://github.com/vivid-brg/dam-butler-mcp.git
cd dam-butler-mcp

# 安装依赖
npm install

# 创建环境文件 (.env)
# 添加你的 OpenAI API 密钥和 Brandfolder 凭证
cat > .env << EOF
OPENAI_API_KEY=your_openai_api_key_here
BRANDFOLDER_CLIENT_ID=your_brandfolder_client_id_here
BRANDFOLDER_CLIENT_SECRET=your_brandfolder_client_secret_here
VAULT_BASE_URL=https://thevault.work/breville
VAULT_API_BASE=https://api.brandfolder.com/v4
BRANDFOLDER_REDIRECT_URI=https://dam-butler-mcp.vercel.app/auth/callback
NODE_ENV=development
EOF

# 测试增强型 MCP 功能
npm test

# 启动本地开发服务器
npm run dev

# 部署到生产环境
npm run deploy

环境变量

# 增强型 AI 意图解析所需
OPENAI_API_KEY=your_openai_key_here              # ✅ 正常工作 - 95% 置信度解析

# 实时 Brandfolder 集成所需
BRANDFOLDER_CLIENT_ID=your_client_id_here        # ⏳ 等待审批
BRANDFOLDER_CLIENT_SECRET=your_client_secret_here # ⏳ 等待审批

# 生产环境自动配置
VAULT_BASE_URL=https://thevault.work/breville
VAULT_API_BASE=https://api.brandfolder.com/v4
BRANDFOLDER_REDIRECT_URI=https://dam-butler-mcp.vercel.app/auth/callback
NODE_ENV=production

项目结构

dam-butler-mcp/
├── api/
│   ├── mcp.js              # ✨ 增强型 MCP 端点，支持完整资产搜索
│   ├── find-brand-assets.js # 智能资产发现逻辑
│   ├── health.js           # 健康监测与诊断
│   ├── authenticate.js     # OAuth 认证流程
│   └── schema.js           # ChatGPT Enterprise 的 OpenAPI 架构
├── src/
│   └── server.js           # 🧠 集成 OpenAI 的 AI 意图解析器
├── config/
│   └── breville-config.json # 📦 500 多种产品目录和品牌映射
├── test-mcp.js             # 🧪 全面测试套件
├── package.json            # 📦 专业开发工作流程
└── vercel.json             # ☁️ 生产环境部署配置

📄 许可证

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

企业使用说明：本软件是为 Breville 内部使用而开发的，并与专有 DAM 系统集成。

🙋‍♂️ 支持与联系

终端用户

• 文档：本 README 和自定义 GPT 中的内联帮助。
• 资产访问问题：联系您团队的 DAM 管理员。
• 功能请求：在 GitHub 上创建带有 “enhancement” 标签的问题。

开发者

• 技术问题：在 GitHub 上创建包含完整错误详细信息的问题。
• 架构问题：查看代码注释和架构文档。
• 部署问题：检查 Vercel 日志和健康端点。

企业用户

• 战略问题：联系 Breville DAM 团队。
• 访问控制：与 IT 和 DAM 管理员合作。
• 定制需求：可提供企业支持。