FindMine 购物造型师

一个 Model Context Protocol (MCP) 服务器，将 FindMine 强大的产品造型和搭配建议功能与 Claude 和其他 MCP 兼容应用程序相结合。

概述

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

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

功能

资源

• 产品：详细的产品信息，带有 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 pull findmine/mcp-server:latest
docker run -it --rm findmine/mcp-server:latest

选项 3：克隆仓库并运行

1. 克隆仓库：

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 安装依赖：

   npm install
   

3. 启动服务器：

   npm start
   

配置

环境变量

以下是推荐的环境变量配置：

使用说明

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
  }
}

开发信息

源代码结构

src/
├── server.js          # 主服务器文件
├── routes/           # API 路由
│   ├── index.js      # 主路由
│   └── style-guide.js  # 风格指南路由
└── utils/            # 工具函数
    └── api.js        # FindMine API 接口封装

贡献指南

1. 叉仓库：

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 创建功能分支：

   git checkout -b feature/your-feature
   

3. 提交更改并推送到原点：

   git add .
   git commit -m "添加你的提交信息"
   git push origin feature/your-feature
   

4. 创建拉取请求。

发布

发布到 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 License 分发。