FindMineショッピングスタイリスト

FindMine の強力な製品スタイリングと装備の推奨事項を Claude やその他の MCP 互換アプリケーションと統合するモデルコンテキストプロトコル (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 ライセンスに基づいてライセンスされています。