FindMine 购物造型师

一个模型上下文协议 (MCP) 服务器，集成了 FindMine 强大的产品造型和服装搭配推荐功能，并与 Claude 和其他 MCP 兼容的应用程序集成。

概述

此 MCP 服务器连接到 FindMine 的造型 API，并通过模型上下文协议将其功能暴露给大型语言模型。它允许用户：

• 浏览产品和服装信息
• 获取特定产品的服装搭配推荐
• 查找视觉上相似的产品
• 访问风格指导和时尚建议

特性

资源

• 产品: 详细的产品信息，使用 product:/// URI 方案
• 搭配: 完整的服装搭配推荐，使用 look:/// URI 方案

工具

• get_style_guide: 访问详细的时尚建议和造型指南
• get_complete_the_look: 获取产品的服装搭配推荐
• get_visually_similar: 查找视觉上相似的产品

提示

• outfit_completion: 获取完整服装的造型建议
• styling_guide: 访问全面的时尚造型指南
• findmine_help: 了解如何使用 FindMine 的工具和资源

安装

选项 1：从 npm 安装

# 直接安装并运行 (推荐)
npx findmine-mcp

# 或者全局安装
npm install -g findmine-mcp
findmine-mcp

选项 2：使用 Docker 运行

docker run -e FINDMINE_APP_ID=your_app_id findmine/mcp-server:latest

选项 3：从源代码克隆和构建

# 克隆仓库
git clone https://github.com/findmine/findmine-mcp.git
cd findmine-mcp

# 安装依赖
npm install

# 构建服务器
npm run build

# 用于开发，自动重新构建
npm run watch

配置

环境变量

变量	描述	默认值
FINDMINE_API_URL	FindMine API 基础 URL	https://api.findmine.com
FINDMINE_APP_ID	您的 FindMine 应用程序 ID	DEMO_APP_ID
FINDMINE_API_VERSION	要使用的 API 版本	v3
FINDMINE_DEFAULT_REGION	默认区域代码	us
FINDMINE_DEFAULT_LANGUAGE	默认语言代码	en
FINDMINE_CACHE_ENABLED	启用响应缓存	true
FINDMINE_CACHE_TTL_MS	缓存生存时间，单位为毫秒	3600000 (1 小时)
NODE_ENV	设置为 "development" 以使用示例数据	-

与 Claude Desktop 一起使用

服务器在安装过程中自动配置 Claude Desktop。要验证：

macOS:

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

type %APPDATA%\Claude\claude_desktop_config.json

开发

MCP 检查器

MCP 检查器是用于测试服务器的开发工具：

npm run inspector

这将在 http://localhost:5173 打开一个 Web 界面，您可以在其中与服务器交互。

开发模式

使用示例数据运行服务器：

NODE_ENV=development npm run build && node build/index.js

自定义风格指南

可以自定义风格指南，以匹配您品牌的特定造型理念和时尚指导。要自定义风格指南：

1. 在 src/index.ts 中找到风格指南（搜索 styleGuides）
2. 修改每个类别的内容（general、color_theory、body_types 等）
3. 通过扩展 styleGuides 对象来添加新类别
4. 自定义特定场合和季节的建议

添加自定义风格指南类别的示例：

// 在 src/index.ts 中
const styleGuides: Record<string, string> = {
  // 现有类别...
  
  // 添加您的自定义类别
  your_brand_style: `# 您的品牌风格指南
  
## 品牌美学
- 品牌视觉识别的关键要素
- 核心风格原则
- 标志性造型和组合

## 您的品牌造型须知
- 品牌特定的造型建议
- 首选的颜色组合
- 标志性的造型技巧

## 您的品牌造型禁忌
- 要避免的组合
- 与品牌形象不符的造型方法
- 要避免的常见造型错误
`
};

对于完整的自定义，您可以修改 src/index.ts 中的整个 get_style_guide 处理程序。

项目结构

• src/index.ts: 主要 MCP 服务器实现
• src/api/: FindMine API 客户端
• src/services/: 业务逻辑和服务层
• src/types/: TypeScript 类型定义
• src/utils/: 实用函数和助手

API 示例

获取风格指南

{
  "name": "get_style_guide",
  "arguments": {
    "category": "color_theory",
    "occasion": "wedding"
  }
}

获取完整造型

{
  "name": "get_complete_the_look",
  "arguments": {
    "product_id": "P12345",
    "product_color_id": "C789"
  }
}

获取视觉上相似的产品

{
  "name": "get_visually_similar",
  "arguments": {
    "product_id": "P12345",
    "product_color_id": "C789",
    "limit": 5
  }
}

发布

发布到 npm

# 登录到 npm
npm login

# 发布包
npm publish

# 更新版本以供将来发布
npm version patch

发布到 Docker Hub

# 构建 Docker 镜像
docker build -t findmine/mcp-server:latest .

# 登录到 Docker Hub
docker login

# 推送镜像
docker push findmine/mcp-server:latest

许可证

本项目采用 MIT 许可证。