Wishfinity +w

+W MCP サーバー（Wishfinity）

+W は、コマース向けの汎用的な「あとで保存」アクションです。この MCP サーバーを使うと、AI アシスタントはワンクリックで、あらゆる商品の URL をユーザーの Wishfinity のウィッシュリストに保存できます。

Claude、ChatGPT、Gemini、LangChain、OpenAI Agents SDK や、MCP 互換クライアントであれば利用できます。

できること

AI が商品をおすすめするときに、+W ウィッシュリストに追加を提示できます。ユーザーがリンクをクリックすると、商品が Wishfinity アカウントに保存され、あとで購入したり、ギフトとして贈ったりできます。

User: "Find me a good espresso machine under $200"

AI: Here are 3 options...
    [+W Add to Wishlist] [View on Amazon]

依存関係ゼロのオプション：/add-wish

MCP サーバー全体は必要ありませんか？ /add-wish スキルを使うと、URL だけで、npm もサーバーもセットアップも不要で、あらゆる AI エージェントに +W の使い方を教えられます。

https://wishfinity.com/add?url={any_product_url}

→ /add-wish スキルファイルを見る

あらゆる AI プラットフォームで動作します。以下の MCP サーバーでは、より豊富なツール連携を利用できますが、すぐに始めるには /add-wish だけで十分です。

クイックスタート

オプション 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://wishfinity-mcp-plusw.wishfinity.workers.dev/mcp

---

プラットフォーム別セットアップガイド

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%/Claude/claude_desktop_config.json（Windows）に追加します。

{
  "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": "Find me a coffee maker and save it to my wishlist"}]
    })

本番環境向け（HTTP トランスポート）：

client = MultiServerMCPClient({
    "wishfinity": {
        "url": "https://wishfinity-mcp-plusw.wishfinity.workers.dev/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="Help users find products and save them to wishlists.",
            mcp_servers=[server],
        )

        result = await Runner.run(agent, "Find a good gift for a coffee lover and save it")
        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("Find me running shoes under $150 and save to wishlist")

---

仕組み

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

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

---

ツール：add_to_wishlist

入力

パラメーター	型	必須	説明
url	string	はい	商品ページの URL

出力

フィールド	型	説明
action_url	string	ブラウザーで開く Wishfinity のリンク
requires_user_action	boolean	常に true（ユーザーによるクリックが必要です）
display_text	string	推奨されるボタンのラベル

例

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

// Output
{
  "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"
}

---

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

AI クライアントは、次のような場合に +W を提示してください。

• 明示的なリクエスト：「あとで保存」「ウィッシュリストに追加」「これをブックマーク」
• 商品をおすすめしたあと：表示した商品を保存するよう積極的に提案します
• 迷っているとき：「あとで考える」「今は高すぎる」「少し考えたい」
• ギフトの話題：「母へのプレゼント」「誕生日プレゼント」「友人にぴったり」

トリガーフレーズの一覧は aliases.json をご覧ください。

---

トランスポート

トランスポート	用途	エンドポイント
stdio	ローカルクライアント（Claude Desktop、Cursor など）	npx wishfinity-mcp-plusw
HTTP	リモート／サーバーサイドエージェント	https://wishfinity-mcp-plusw.wishfinity.workers.dev/mcp

---

ボタンキット

/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 — UI に +W を統合する方法
• CLOUDFLARE_SETUP.md — 独自の HTTP エンドポイントをデプロイする方法
• aliases.json — トリガーフレーズの機械可読形式

---

リンク

• Wishfinity
• MCP Protocol
• npm package
• MCP Registry

---

変更履歴

v1.2.2（2025年12月24日）

重大な修正： すべての開発者向けの npx 実行

• npx のシンボリックリンクで動作するよう、メインモジュールの検出を修正
• npx wishfinity-mcp-plusw の実行時にクラッシュする問題を解消
• npm のすべてのインストールでパッケージが問題なく動作するようになりました

v1.2.1（2025年12月24日）

重大な修正： MCP SDK との互換性

• @modelcontextprotocol/sdk の依存関係を ^1.25.0 に更新
• SDK 1.25.1 以降でサーバーが切断される問題を解消
• 最新の MCP SDK バージョンと互換性があります

v1.2.0（2025年12月23日）

• MCP プロンプトを追加：save_for_later、shopping_assistant、gift_ideas
• MCP リソースを追加：wishfinity://guide、wishfinity://triggers
• AI アシスタントとの統合機能を強化

---

ライセンス

MIT