FindMine 购物造型师

一个 Model Context Protocol (MCP) 服务器，将 FindMine 强大的产品造型和搭配推荐与 Claude 及其他 MCP 兼容应用程序集成在一起。

概述

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

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

功能

资源

• Products：带有 product:/// URI 方案的详细产品信息
• Looks：带有 look:/// URI 方案的完整搭配建议

工具

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

提示

• outfit_completion：获取完整的搭配建议
• styling_guide：访问全面的时尚造型指南
• findmine_help：学习如何使用 FindMine 的工具和资源

安装

选项 1：从 npm 安装

bash

直接安装并运行（推荐）

npx findmine-mcp

或者全局安装

npm install -g findmine-mcp
findmine-mcp

选项 2：使用 Docker 运行

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

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

bash

克隆仓库

git clone https://github.com/findmine/findmine-mcp.git
cd findmine-mcp

安装依赖

npm install

构建服务器

npm run build

开发模式下自动重建

npm run watch

配置

环境变量

与 Claude Desktop 一起使用

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

macOS:
bash
cat ~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

type %APPDATA%Claudeclaude_desktop_config.json

开发

MCP Inspector

MCP Inspector 是一个用于测试您的服务器的开发工具：

bash
npm run inspector

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

开发模式

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

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

自定义风格指南

风格指南可以根据您的品牌特定的造型理念和时尚指导进行自定义。要自定义风格指南：

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

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

typescript
// 在 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 示例

获取风格指南

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

获取完整搭配

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

获取视觉相似产品

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

发布

发布到 npm

bash

登录 npm

npm login

发布包

npm publish

更新版本以备将来发布

npm version patch

发布到 Docker Hub

bash

构建 Docker 镜像

docker build -t findmine/mcp-server:latest .

登录 Docker Hub

docker login

推送镜像

docker push findmine/mcp-server:latest

许可证

本项目采用 MIT 许可证。