shield_lock
JinDaGe
← Back to MCP directory
publicPublicdnsLocal runtime

wishfinity-mcp-plusw

Wishfinity的MCP服务器，为AI助手提供一键保存商品链接到用户心愿单的功能，支持多种AI平台和MCP客户端。

article

README

🚀 +W MCP服务器 (Wishfinity)

+W 是一种通用的商业“稍后保存”操作。这个MCP服务器允许AI助手一键将任何产品URL保存到用户的 Wishfinity 愿望清单中。

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

npm version License: MIT

🚀 快速开始

选项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"
}

📚 详细文档

🔧 技术细节

工作原理

  1. AI调用 add_to_wishlist 工具并传入产品URL。
  2. MCP服务器返回一个Wishfinity链接：https://wishfinity.com/add?url=...。
  3. 用户点击链接 → 登录（仅首次需要）→ 产品被保存。
  4. 用户可以稍后整理、分享或购买该产品。

无需API密钥。当用户点击链接时，认证将在Wishfinity网站上进行。

工具：add_to_wishlist

输入

| 参数 | 类型 | 是否必需 | 描述 | | ---- | ---- | ---- | ---- | | url | 字符串 | 是 | 产品页面URL |

输出

| 字段 | 类型 | 描述 | | ---- | ---- | ---- | | action_url | 字符串 | 在浏览器中打开的Wishfinity链接 | | requires_user_action | 布尔值 | 始终为 true（用户必须点击） | | display_text | 字符串 | 建议的按钮标签 |

何时提供 +W

AI客户端应在以下情况下提供 +W：

  • 明确请求：如“稍后保存”、“添加到愿望清单”、“收藏此商品”。
  • 推荐产品后：主动提供保存所展示商品的选项。
  • 犹豫时刻：如“以后再说”、“现在太贵了”、“需要考虑一下”。
  • 送礼场景：如“给我妈妈的”、“生日礼物”、“非常适合我的朋友”。

完整的触发短语列表请参见 aliases.json。

传输方式

| 传输方式 | 使用场景 | 端点 | | ---- | ---- | ---- | | 标准输入输出 | 本地客户端（Claude桌面版、Cursor等） | npx wishfinity-mcp-plusw | | HTTP | 远程/服务器端代理 | https://mcp.wishfinity.com/mcp |

按钮套件

/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许可证。

🔗 相关链接

📝 更新日志

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client