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
   

📚 ドキュメント

環境変数

以下は推奨される環境変数の設定です：

💻 使用例

基本的な使用法

スタイルガイドを取得する

{
  "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 に基づいて配布されています。