JinDaGe - findmine-mcp MCP Details

article

README

🚀 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：克隆仓库并运行

克隆仓库：

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

安装依赖：
```
npm install
```
启动服务器：
```
npm start
```

📚 详细文档

配置

环境变量

以下是推荐的环境变量配置： | 属性 | 详情 | |------|------| | NODE_ENV | 设置运行环境，可以是 development 或 production，默认值为 development | | PORT | 指定服务器监听的端口，默认值为 3000 | | API_KEY | FindMine API 的密钥，默认值为 your-api-key | | DATABASE_URL | 数据库连接 URL，默认值为 sqlite://db.sqlite |

使用说明

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 接口封装

贡献指南

叉仓库：

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

创建功能分支：
```
git checkout -b feature/your-feature
```

提交更改并推送到原点：

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

创建拉取请求。

发布

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

findmine-mcp