Findmine Mcp

🚀 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 分发。