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，就能教会任何 AI Agent 使用 +W 模式，无需 npm、服务或任何设置：

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 传输）

最适用于服务端 Agent、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	远程/服务端 Agent	https://wishfinity-mcp-plusw.wishfinity.workers.dev/mcp

---

按钮套件

如果你想统一 +W 按钮的外观，/button-kit 文件夹中包含可选的 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 — 机器可读的触发短语

---

链接

• Wishfinity
• MCP 协议
• npm 包
• 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