Wishfinity MCP Plusw

🚀 +W MCP Server (Wishfinity)

+W は、コマースにおける普遍的な「後で保存」アクションです。このMCPサーバーにより、AIアシスタントはユーザーの Wishfinity ウィッシュリストに任意の商品URLをワンクリックで保存できます。

Claude、ChatGPT、Gemini、LangChain、OpenAI Agents SDK およびMCP互換のクライアントと連携します。

🚀 クイックスタート

オプション1: ローカルインストール (stdioトランスポート)

Claude Desktop、ChatGPT Desktop、Cursor、VS Code、およびローカル開発に最適です。

npm install wishfinity-mcp-plusw

MCPクライアントの設定に追加します。

{
  "mcpServers": {
    "wishfinity": {
      "command": "npx",
      "args": ["wishfinity-mcp-plusw"]
    }
  }
}

オプション2: リモートエンドポイント (HTTPトランスポート)

サーバーサイドのエージェント、LangChainの本番デプロイ、およびホスト型AIアプリケーションに最適です。

https://mcp.wishfinity.com/mcp

または、Cloudflare WorkersのURLを使用します。

https://wishfinity-mcp-plusw.wishfinity.workers.dev/mcp

✨ 主な機能

AIが商品を推薦する際に、+W ウィッシュリストに追加 を提供できます。ユーザーがリンクをクリックすると、商品が彼らのWishfinityアカウントに保存され、後で購入または贈り物に使える状態になります。

ユーザー: "200ドル以下の良いエスプレッソマシンを探してください"

AI: これが3つの選択肢です...
    [+W ウィッシュリストに追加] [Amazonで表示]

📦 インストール

Claude Desktop

macOSの場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windowsの場合は %APPDATA%/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "wishfinity": {
      "command": "npx",
      "args": ["wishfinity-mcp-plusw"]
    }
  }
}

ChatGPT Desktop

MCPサポートが利用可能になったら、ChatGPTのMCP設定に追加します。

{
  "mcpServers": {
    "wishfinity": {
      "command": "npx",
      "args": ["wishfinity-mcp-plusw"]
    }
  }
}

Cursor

プロジェクトの .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "wishfinity": {
      "command": "npx",
      "args": ["wishfinity-mcp-plusw"]
    }
  }
}

LangChain

from langchain_mcp_adapters.client import MultiServerMCPClient
from langchain.agents import create_agent

async def main():
    client = MultiServerMCPClient({
        "wishfinity": {
            "command": "npx",
            "args": ["wishfinity-mcp-plusw"],
            "transport": "stdio",
        }
    })
    
    tools = await client.get_tools()
    agent = create_agent("openai:gpt-4", tools)
    
    result = await agent.ainvoke({
        "messages": [{"role": "user", "content": "コーヒーメーカーを探してウィッシュリストに保存してください"}]
    })

本番環境 (HTTPトランスポート) の場合:

client = MultiServerMCPClient({
    "wishfinity": {
        "url": "https://mcp.wishfinity.com/mcp",
        "transport": "streamable_http",
    }
})

OpenAI Agents SDK

from agents import Agent, Runner
from agents.mcp import MCPServerStdio

async def main():
    async with MCPServerStdio(
        name="wishfinity",
        params={
            "command": "npx",
            "args": ["wishfinity-mcp-plusw"],
        },
    ) as server:
        agent = Agent(
            name="Shopping Assistant",
            instructions="ユーザーが商品を探し、ウィッシュリストに保存できるように支援します。",
            mcp_servers=[server],
        )
        
        result = await Runner.run(agent, "コーヒー好きの人に良い贈り物を探して保存してください")
        print(result.final_output)

Hugging Face Agents

from huggingface_hub import Agent

agent = Agent(
    model="meta-llama/Llama-3.1-70B-Instruct",
    mcp_servers=[{
        "command": "npx",
        "args": ["wishfinity-mcp-plusw"]
    }]
)

response = agent.run("150ドル以下のランニングシューズを探してウィッシュリストに保存してください")

🔧 技術詳細

1. AIが商品URLを指定して add_to_wishlist ツールを呼び出します。
2. MCPサーバーがWishfinityのリンクを返します: https://wishfinity.com/add?url=...
3. ユーザーがリンクをクリックすると、初回のみログインし、商品が保存されます。
4. ユーザーは後で商品を整理、共有、または購入できます。

APIキーは不要です。 認証は、ユーザーがリンクをクリックしたときにWishfinityのウェブサイトで行われます。

💻 使用例

基本的な使用法

// 入力
{ "url": "https://amazon.com/dp/B0EXAMPLE" }

// 出力
{
  "action_url": "https://wishfinity.com/add?url=https%3A%2F%2Famazon.com%2Fdp%2FB0EXAMPLE",
  "requires_user_action": true,
  "display_text": "Open to add to Wishfinity"
}

📚 ドキュメント

ツール: add_to_wishlist

入力

出力

+Wを提供するタイミング

AIクライアントは、以下の場合に+Wを提供する必要があります。

• 明示的な要求: "後で保存する"、"ウィッシュリストに追加する"、"これをブックマークする"
• 商品を推薦した後: 表示された商品を保存するオプションを積極的に提供する
• 迷いの瞬間: "後でもいい"、"今は高すぎる"、"考えてみる必要がある"
• 贈り物の文脈: "母のために"、"誕生日プレゼント"、"友達にぴったり"

トリガーフレーズの完全なリストについては、aliases.json を参照してください。

トランスポート

ボタンキット

/button-kit フォルダには、一貫した+Wボタンの外観が必要な場合のオプションのUIアセット (SVGアイコン、HTML/CSSスニペット) が含まれています。 CDNのURL:

• 小: https://cdn.jsdelivr.net/npm/wishfinity-mcp-plusw@latest/button-kit/Wishfinity-Button-Small.svg
• 中: https://cdn.jsdelivr.net/npm/wishfinity-mcp-plusw@latest/button-kit/Wishfinity-Button-Medium.svg
• 大: https://cdn.jsdelivr.net/npm/wishfinity-mcp-plusw@latest/button-kit/Wishfinity-Button-Large.svg

その他のドキュメント

• SPEC.md — 完全な技術仕様
• INTEGRATION_GUIDE.md — +WをUIに統合する方法
• CLOUDFLARE_SETUP.md — 独自のHTTPエンドポイントをデプロイする方法
• aliases.json — 機械可読のトリガーフレーズ

📄 ライセンス

MIT