金大哥 - yachtsy-mcp-server MCP 详情

article

README

🚀 Yachtsy：游艇市场情报多客户端协议（MCP）服务

Yachtsy MCP 服务器通过与 Yachtsy 代理 API 集成，提供由人工智能驱动的游艇和船只市场情报。你可以在 Claude Desktop、Cursor 等流行的 MCP 客户端中访问超过 25,000 条船只列表，获取专业的航海建议，并找到你理想的船只。

🚀 快速开始

若要使用 Yachtsy MCP，你需要：

在 Yachtsy.ai 上注册一个免费账户。
在你的仪表盘上导航到 API 密钥。
生成一个新的 API 密钥。
在你的配置中使用这个 API 密钥作为 YACHTSY_API_KEY 的值。

✨ 主要特性

✅ 智能代理路由：自动将你的查询路由到最合适的专业代理：
- 列表代理：使用高级过滤功能搜索超过 25,000 条船只列表。
- 通用船只专家（闲聊代理）：解答通用的航海和船只问题。
- 深度研究代理：提供全面的游艇市场分析。
✅ 全面的船只列表：可按以下条件进行搜索和过滤：
- 品牌、型号和类别
- 价格范围和货币
- 位置（城市、国家、地区）
- 年份、长度和规格
- 经纪人和经销商信息
✅ 专业航海知识：获取以下方面的建议：
- 船只选择和推荐
- 远洋巡航准备
- 航海技术和最佳实践
- 游艇维护和系统

📦 安装指南

在安装或运行 Yachtsy MCP 之前，你需要在系统上安装 npx（它随 Node.js 和 npm 一起提供）。

Mac（macOS）

安装 Homebrew（如果你还没有安装）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装 Node.js（包含 npm 和 npx）：

brew install node

验证安装：

node -v
npm -v
npx -v

Windows

下载 Node.js 安装程序：

访问 https://nodejs.org/ 并下载适用于 Windows 的 LTS 版本。

运行安装程序 并按照提示操作。这将安装 Node.js、npm 和 npx。
验证安装：打开命令提示符并运行：

node -v
npm -v
npx -v

在不同客户端运行

在 Claude Desktop 上运行

要为 Claude Desktop 配置 Yachtsy MCP：

打开 Claude Desktop。
转到设置 > 开发者 > 编辑配置。
在你的 claude_desktop_config.json 中添加以下内容：

{
  "mcpServers": {
    "yachtsy-mcp-server": {
      "command": "npx",
      "args": ["-y", "yachtsy-mcp@latest"],
      "env": {
        "YACHTSY_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

重启 Claude 以使更改生效。

在 Cursor 上运行

注意：需要 Cursor 版本 0.45.6 或更高版本。要在 Cursor 中配置 Yachtsy MCP：

打开 Cursor 设置。
转到功能 > MCP 服务器。
点击“+ 添加新的 MCP 服务器”。
输入以下内容：

名称：“yachtsy-mcp”（或你喜欢的名称）
类型：“命令”
命令：env YACHTSY_API_KEY=your-yachtsy-api-key npx -y yachtsy-mcp

如果你使用的是 Windows 并且遇到问题，请尝试 cmd /c "set YACHTSY_API_KEY=your-yachtsy-api-key && npx -y yachtsy-mcp"

将 your-yachtsy-api-key 替换为你的 Yachtsy API 密钥。添加后，刷新 MCP 服务器列表以查看新工具。当涉及游艇相关查询时，Composer 代理将自动使用 Yachtsy MCP。

在 Windsurf 上运行

在你的 ./codeium/windsurf/model_config.json 中添加以下内容：

{
  "mcpServers": {
    "yachtsy-mcp-server": {
      "command": "npx",
      "args": ["-y", "yachtsy-mcp@latest"],
      "env": {
        "YACHTSY_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

使用 npx 运行

env YACHTSY_API_KEY=your_yachtsy_api_key npx -y yachtsy-mcp

手动安装

npm install -g yachtsy-mcp

💻 使用示例

可用工具 - yachtsy - agent

[游艇市场情报] 主要的 Yachtsy 代理，可自动路由到专业子代理。

功能：

搜索超过 25,000 条船只和游艇列表。
按品牌、型号、价格、位置、年份、长度等进行过滤。
获取详细的游艇规格和经纪人信息。
接收专业的航海和巡航建议。
研究游艇市场趋势和价值。
获取船只买卖建议。

适用场景：任何与游艇或船只相关的查询 - 该代理将自动为你的需求选择最合适的专业子代理。

示例查询：

Show me Catalina 34 sailboats under $100k
Find Tayana 37 listings in good condition
What are the best bluewater cruising boats between 40 - 50 feet?
Find me yacht listings in the Caribbean under $200k
Tell me about the Hallberg - Rassy 42
What should I look for when buying a used cruising sailboat?
Compare the Island Packet 380 vs Pacific Seacraft 40
Show me center cockpit sailboats suitable for ocean crossing
What are the maintenance costs for a 40 - foot sailboat?
Find me aluminum hulled sailboats for world cruising

示例用例

船只选购

"Show me Catalina 34 sailboats under $80,000 in California"
"Find bluewater cruising boats between 38 - 45 feet suitable for a couple"
"What Hallberg - Rassy boats are available in Europe?"

游艇研究

"Tell me about the Tayana 37 and its reputation for offshore cruising"
"Compare the Island Packet 380 vs the Passport 40 for liveaboard cruising"
"What are the common issues with the Beneteau Oceanis 46?"

航海建议

"What should I look for when buying a used bluewater cruising sailboat?"
"Recommend a good first sailboat for a family of four under $50k"
"What are the best boats for single - handed sailing?"

市场情报

"What's the typical price range for a 1985 Tayana 37 in good condition?"
"Show me market trends for 40 - foot cruising catamarans"
"Find me the most popular boats for sale under $100k"

📚 详细文档

有关 Yachtsy 人工智能代理的全面文档，请访问：https://www.yachtsy.ai

🔧 技术细节

故障排除

API 密钥问题：确保你的 Yachtsy API 密钥已正确设置在环境变量或配置文件中。
连接问题：验证 https://api.yachtsy.ai 是否可以从你的网络访问。
速率限制：如果你遇到速率限制，请降低请求频率。

环境变量

YACHTSY_API_KEY=your-api-key-here              # 必需
YACHTSY_API_BASE_URL=https://api.yachtsy.ai/v1  # 可选，默认为生产环境

📄 许可证

本项目采用 MIT 许可证。

关于 Yachtsy

Yachtsy AI 是智能游艇市场助手，可帮助水手和游艇爱好者找到他们理想的船只。通过访问超过 25,000 条列表和专业的航海知识，Yachtsy 让船只选购和航海研究变得轻松。

访问 www.yachtsy.ai 了解更多信息。

⭐ 如果你觉得这个项目有帮助，请给这个仓库点个星！

yachtsy-mcp-server