Findmine MCP

🚀 FindMine 購物造型師

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 分發。