Yachtsy MCP Server

🚀 Yachtsy：遊艇市場情報多客戶端協議（MCP）服務

Yachtsy MCP 服務器通過與 Yachtsy 代理 API 集成，提供由人工智能驅動的遊艇和船隻市場情報。你可以在 Claude Desktop、Cursor 等流行的 MCP 客戶端中訪問超過 25,000 條船隻列表，獲取專業的航海建議，並找到你理想的船隻。

🚀 快速開始

若要使用 Yachtsy MCP，你需要：

1. 在 Yachtsy.ai 上註冊一個免費賬戶。
2. 在你的儀表盤上導航到 API 密鑰。
3. 生成一個新的 API 密鑰。
4. 在你的配置中使用這個 API 密鑰作為 YACHTSY_API_KEY 的值。

✨ 主要特性

• ✅ 智能代理路由：自動將你的查詢路由到最合適的專業代理：
  • 列表代理：使用高級過濾功能搜索超過 25,000 條船隻列表。
  • 通用船隻專家（閒聊代理）：解答通用的航海和船隻問題。
  • 深度研究代理：提供全面的遊艇市場分析。
• ✅ 全面的船隻列表：可按以下條件進行搜索和過濾：
  • 品牌、型號和類別
  • 價格範圍和貨幣
  • 位置（城市、國家、地區）
  • 年份、長度和規格
  • 經紀人和經銷商信息
• ✅ 專業航海知識：獲取以下方面的建議：
  • 船隻選擇和推薦
  • 遠洋巡航準備
  • 航海技術和最佳實踐
  • 遊艇維護和系統

📦 安裝指南

在安裝或運行 Yachtsy MCP 之前，你需要在系統上安裝 npx（它隨 Node.js 和 npm 一起提供）。

Mac（macOS）

1. 安裝 Homebrew（如果你還沒有安裝）：

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

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

brew install node

3. 驗證安裝：

node -v
npm -v
npx -v

Windows

1. 下載 Node.js 安裝程序：

• 訪問 https://nodejs.org/ 並下載適用於 Windows 的 LTS 版本。

2. 運行安裝程序 並按照提示操作。這將安裝 Node.js、npm 和 npx。
3. 驗證安裝： 打開命令提示符並運行：

node -v
npm -v
npx -v

在不同客戶端運行

在 Claude Desktop 上運行

要為 Claude Desktop 配置 Yachtsy MCP：

1. 打開 Claude Desktop。
2. 轉到設置 > 開發者 > 編輯配置。
3. 在你的 claude_desktop_config.json 中添加以下內容：

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

4. 重啟 Claude 以使更改生效。

在 Cursor 上運行

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

1. 打開 Cursor 設置。
2. 轉到功能 > MCP 服務器。
3. 點擊“+ 添加新的 MCP 服務器”。
4. 輸入以下內容：

• 名稱：“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

🔧 技術細節

故障排除

1. API 密鑰問題：確保你的 Yachtsy API 密鑰已正確設置在環境變量或配置文件中。
2. 連接問題：驗證 https://api.yachtsy.ai 是否可以從你的網絡訪問。
3. 速率限制：如果你遇到速率限制，請降低請求頻率。

環境變量

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 瞭解更多信息。

⭐ 如果你覺得這個項目有幫助，請給這個倉庫點個星！