Wishfinity MCP Plusw

🚀 +W MCP服務器 (Wishfinity)

+W 是一種通用的商業“稍後保存”操作。這個MCP服務器允許AI助手一鍵將任何產品URL保存到用戶的 Wishfinity 願望清單中。

它可與 Claude、ChatGPT、Gemini、LangChain、OpenAI Agents SDK 以及任何兼容MCP的客戶端配合使用。

🚀 快速開始

選項1：本地安裝（標準輸入輸出傳輸）

此方式最適合Claude桌面版、ChatGPT桌面版、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添加到願望清單] [在亞馬遜查看]

📦 安裝指南

Claude桌面版

在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桌面版

當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="購物助手",
            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美元的跑鞋並保存到願望清單中")

💻 使用示例

基礎用法

// 輸入
{ "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": "點擊添加到Wishfinity"
}

📚 詳細文檔

• SPEC.md — 完整的技術規範
• INTEGRATION_GUIDE.md — 如何將 +W 集成到你的用戶界面中
• CLOUDFLARE_SETUP.md — 部署你自己的HTTP端點
• aliases.json — 機器可讀的觸發短語

🔧 技術細節

工作原理

1. AI調用 add_to_wishlist 工具並傳入產品URL。
2. MCP服務器返回一個Wishfinity鏈接：https://wishfinity.com/add?url=...。
3. 用戶點擊鏈接 → 登錄（僅首次需要）→ 產品被保存。
4. 用戶可以稍後整理、分享或購買該產品。

無需API密鑰。當用戶點擊鏈接時，認證將在Wishfinity網站上進行。

工具：add_to_wishlist

輸入

輸出

何時提供 +W

AI客戶端應在以下情況下提供 +W：

• 明確請求：如“稍後保存”、“添加到願望清單”、“收藏此商品”。
• 推薦產品後：主動提供保存所展示商品的選項。
• 猶豫時刻：如“以後再說”、“現在太貴了”、“需要考慮一下”。
• 送禮場景：如“給我媽媽的”、“生日禮物”、“非常適合我的朋友”。

完整的觸發短語列表請參見 aliases.json。

傳輸方式

按鈕套件

/button-kit 文件夾包含可選的UI資產（SVG圖標、HTML/CSS代碼片段），如果你希望 +W 按鈕外觀保持一致，可以使用這些資產。

CDN鏈接：

• 小尺寸：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

📄 許可證

本項目採用MIT許可證。

🔗 相關鏈接

• Wishfinity
• MCP協議
• npm包
• MCP註冊表

📝 更新日誌

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助手的集成能力。