FindMine购物造型师
模型上下文协议 (MCP) 服务器将 FindMine 强大的产品样式和装备推荐与 Claude 和其他 MCP 兼容应用程序相集成。
概述
此 MCP 服务器连接到 FindMine 的样式 API，并通过模型上下文协议将其功能开放给大型语言模型。它允许用户：
浏览产品和服装信息
获取特定产品的服装推荐
查找外观相似的产品
获得风格指导和时尚建议
Related MCP server: Perplexity MCP Server
特征
资源
工具
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 是一个用于测试服务器的开发工具：
这将在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 许可。
