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