FindMine购物造型师

模型上下文协议 (MCP) 服务器将 FindMine 强大的产品样式和装备推荐与 Claude 和其他 MCP 兼容应用程序相集成。

概述

此 MCP 服务器连接到 FindMine 的样式 API，并通过模型上下文协议将其功能开放给大型语言模型。它允许用户：

浏览产品和服装信息
获取特定产品的服装推荐
查找外观相似的产品
获得风格指导和时尚建议

特征

资源

产品：带有product:/// URI 方案的详细产品信息
外观：使用look:/// URI 方案提供完整的服装推荐

工具

get_style_guide ：获取详细的时尚建议和造型指南
get_complete_the_look ：获取产品的服装推荐
get_visually_similar ：查找外观相似的产品

提示

outfit_completion ：获取完整服装的造型建议
styling_guide ：获取全面的时尚造型指南
findmine_help ：了解如何使用 FindMine 的工具和资源

安装

选项 1：从 npm 安装

# Install and run directly (recommended)
npx findmine-mcp

# Or install globally
npm install -g findmine-mcp
findmine-mcp

选项 2：使用 Docker 运行

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

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

# Clone the repository
git clone https://github.com/findmine/findmine-mcp.git
cd findmine-mcp

# Install dependencies
npm install

# Build the server
npm run build

# For development with auto-rebuild
npm run watch

配置

环境变量

多变的	描述	默认
`FINDMINE_API_URL`	FindMine API 基本 URL	https://api.findmine.com
`FINDMINE_APP_ID`	您的 FindMine 应用程序 ID	演示应用程序 ID
`FINDMINE_API_VERSION`	要使用的 API 版本	v3
`FINDMINE_DEFAULT_REGION`	默认区域代码	我们
`FINDMINE_DEFAULT_LANGUAGE`	默认语言代码	英文
`FINDMINE_CACHE_ENABLED`	启用响应缓存	真的
`FINDMINE_CACHE_TTL_MS`	缓存生存时间（毫秒）	3600000（1小时）
`NODE_ENV`	设置为“开发”以获取示例数据	-

与 Claude Desktop 一起使用

服务器在安装过程中会自动配置 Claude Desktop。验证方法如下：

macOS：

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

视窗：

type %APPDATA%\Claude\claude_desktop_config.json

发展

MCP 检查器

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

npm run inspector

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

开发模式

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

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

自定义样式指南

风格指南可根据您的品牌特定造型理念和时尚指导进行定制。定制风格指南的步骤如下：

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

添加自定义样式指南类别的示例：

// In src/index.ts
const styleGuides: Record<string, string> = {
  // Existing categories...
  
  // Add your custom category
  your_brand_style: `# Your Brand Style Guide
  
## Brand Aesthetic
- Key elements of your brand's visual identity
- Core style principles
- Signature looks and combinations

## Your Brand's Styling Do's
- Brand-specific styling recommendations
- Preferred color combinations
- Signature styling techniques

## Your Brand's Styling Don'ts
- Combinations to avoid
- Styling approaches that don't align with brand identity
- Common styling mistakes to avoid
`
};

为了完全自定义，您可以修改src/index.ts中的整个get_style_guide处理程序。

项目结构

src/index.ts ：主 MCP 服务器实现
src/api/ ：FindMine API 客户端
src/services/ ：业务逻辑和服务层
src/types/ ：TypeScript 类型定义
src/utils/ ：实用程序函数和助手

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

出版

发布到 npm

# Login to npm
npm login

# Publish the package
npm publish

# Update the version for future releases
npm version patch

发布到 Docker Hub

# Build the Docker image
docker build -t findmine/mcp-server:latest .

# Login to Docker Hub
docker login

# Push the image
docker push findmine/mcp-server:latest

执照

该项目已获得 MIT 许可。