Tavily

ทางการ

เซิร์ฟเวอร์ Tavily MCP อย่างเป็นทางการสำหรับการค้นหาด้วย AI และการดึงเนื้อหา มอบเครื่องมือค้นหาเว็บ การรวบรวมข้อมูล และการดึงข้อมูลให้กับไคลเอนต์ MCP

GitHub
2.2k

คุณทำอะไรได้บ้างด้วย Tavily MCP?

  • ค้นหาเว็บแบบเรียลไทม์ — สอบถามข้อมูลปัจจุบัน ข่าวสาร หรือคำตอบโดยใช้ tavily-search
  • ดึงเนื้อหาที่มีโครงสร้างจาก URL — ดึงข้อมูลที่สะอาดและเกี่ยวข้องจากหน้าเว็บเฉพาะด้วย tavily-extract
  • แผนผังโครงสร้างเว็บไซต์ — รับภาพรวมของหน้าและส่วนต่างๆ บนโดเมนผ่าน tavily-map
  • รวบรวมข้อมูลเว็บไซต์อย่างเป็นระบบ — สำรวจหลายหน้าที่เชื่อมโยงกันจาก URL เริ่มต้นโดยใช้ tavily-crawl

เอกสาร

Tavily MCP Server

GitHub Repo stars npm smithery badge

เซิร์ฟเวอร์ Tavily MCP มีเครื่องมือดังนี้:

  • เครื่องมือค้นหา, ดึงข้อมูล, สร้างแผนผัง, และรวบรวมข้อมูล
  • ความสามารถในการค้นหาเว็บแบบเรียลไทม์ผ่านเครื่องมือ tavily-search
  • การดึงข้อมูลอัจฉริยะจากหน้าเว็บผ่านเครื่องมือ tavily-extract
  • เครื่องมือสร้างแผนผังเว็บไซต์อันทรงพลังที่สร้างแผนผังโครงสร้างของเว็บไซต์
  • โปรแกรมรวบรวมข้อมูลเว็บที่สำรวจเว็บไซต์อย่างเป็นระบบ

📚 แหล่งข้อมูลที่เป็นประโยชน์

  • บทช่วยสอน เกี่ยวกับการรวม Tavily MCP เข้ากับเซิร์ฟเวอร์ Neo4j MCP
  • บทช่วยสอน เกี่ยวกับการรวม Tavily MCP เข้ากับ Cline ใน VS Code

เซิร์ฟเวอร์ MCP ระยะไกล

เชื่อมต่อโดยตรงกับเซิร์ฟเวอร์ MCP ระยะไกลของ Tavily แทนการรันในเครื่อง ซึ่งมอบประสบการณ์ที่ราบรื่นโดยไม่ต้องติดตั้งหรือกำหนดค่าในเครื่อง

เพียงใช้ URL เซิร์ฟเวอร์ MCP ระยะไกลพร้อมกับคีย์ API Tavily ของคุณ:

https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

รับคีย์ API Tavily ของคุณจาก tavily.com

หรือคุณสามารถส่งคีย์ API ของคุณผ่านส่วนหัว Authorization หากไคลเอนต์ MCP รองรับ:

Authorization: Bearer <your-api-key>

หมายเหตุ: เมื่อใช้ MCP ระยะไกล คุณสามารถระบุพารามิเตอร์เริ่มต้นสำหรับคำขอทั้งหมดได้โดยรวมส่วนหัว DEFAULT_PARAMETERS ที่มีออบเจกต์ JSON พร้อมค่าเริ่มต้นที่คุณต้องการ ตัวอย่าง:

{"include_images":true, "search_depth": "basic", "max_results": 10}

เชื่อมต่อกับ Claude Code

Claude Code เป็นเครื่องมือ CLI อย่างเป็นทางการของ Anthropic สำหรับ Claude คุณสามารถเพิ่มเซิร์ฟเวอร์ Tavily MCP ได้โดยใช้คำสั่ง claude mcp add มีสองวิธีในการยืนยันตัวตน:

ตัวเลือกที่ 1: คีย์ API ใน URL

ส่งคีย์ API ของคุณโดยตรงใน URL แทนที่ <your-api-key> ด้วย คีย์ API Tavily จริงของคุณ:

claude mcp add --transport http tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

ตัวเลือกที่ 2: ขั้นตอนการยืนยันตัวตนแบบ OAuth

เพิ่มเซิร์ฟเวอร์โดยไม่มีคีย์ API ใน URL:

claude mcp add --transport http tavily https://mcp.tavily.com/mcp

หลังจากเพิ่มแล้ว คุณจะต้องทำขั้นตอนการยืนยันตัวตนให้เสร็จสมบูรณ์:

  1. รัน claude เพื่อเริ่ม Claude Code
  2. พิมพ์ /mcp เพื่อเปิดการจัดการเซิร์ฟเวอร์ MCP
  3. เลือกเซิร์ฟเวอร์ Tavily และทำกระบวนการยืนยันตัวตนให้เสร็จสมบูรณ์

เคล็ดลับ: เพิ่ม --scope user ในคำสั่งใดก็ได้เพื่อให้เซิร์ฟเวอร์ Tavily MCP พร้อมใช้งานทั่วโลกในทุกโปรเจกต์ของคุณ:

claude mcp add --transport http --scope user tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

เมื่อกำหนดค่าแล้ว คุณจะสามารถเข้าถึงเครื่องมือค้นหา, ดึงข้อมูล, สร้างแผนผัง, และรวบรวมข้อมูลของ Tavily ได้

เชื่อมต่อกับ Cursor

Install MCP Server

คลิกปุ่ม ⬆️ เพิ่มไปยัง Cursor ⬆️ ซึ่งจะจัดการส่วนใหญ่ให้คุณ แต่คุณยังต้องแก้ไขการกำหนดค่าเพื่อเพิ่มคีย์ API ของคุณ คุณสามารถรับคีย์ API Tavily ได้ ที่นี่

เมื่อคุณคลิกปุ่ม คุณควรถูกเปลี่ยนเส้นทางไปยัง Cursor ...

ขั้นตอนที่ 1

คลิกปุ่มติดตั้ง

ขั้นตอนที่ 2

คุณควรเห็นว่า MCP ได้รับการติดตั้งแล้ว หากแถบเลื่อนสีน้ำเงินยังไม่เปิด ให้เปิดด้วยตนเอง คุณยังต้องแก้ไขการกำหนดค่าเพื่อรวมคีย์ API Tavily ของคุณเอง

ขั้นตอนที่ 3

จากนั้นคุณจะถูกเปลี่ยนเส้นทางไปยังไฟล์ mcp.json ของคุณ ซึ่งคุณต้องเพิ่ม your-api-key

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>",
      "env": {}
    }
  }
}

ขั้นตอน OAuth ของเซิร์ฟเวอร์ MCP ระยะไกล

เซิร์ฟเวอร์ Tavily MCP ระยะไกลรองรับการยืนยันตัวตนแบบ OAuth ที่ปลอดภัย ช่วยให้คุณเชื่อมต่อและอนุญาตได้อย่างราบรื่นกับไคลเอนต์ที่เข้ากันได้

วิธีการตั้งค่าการยืนยันตัวตนแบบ OAuth

A. การใช้ MCP Inspector:

  • เปิด MCP Inspector และคลิก "Open Auth Settings"
  • เลือกขั้นตอน OAuth และทำตามขั้นตอนเหล่านี้:
    1. การค้นพบเมทาดาทา
    2. การลงทะเบียนไคลเอนต์
    3. การเตรียมการอนุญาต
    4. ขอการอนุญาตและรับรหัสการอนุญาต
    5. การขอโทเค็น
    6. การยืนยันตัวตนเสร็จสมบูรณ์

เมื่อเสร็จสิ้น คุณจะได้รับโทเค็นการเข้าถึงที่ช่วยให้คุณส่งคำขอที่ยืนยันตัวตนไปยังเซิร์ฟเวอร์ Tavily MCP ระยะไกลได้อย่างปลอดภัย

B. การใช้ไคลเอนต์ MCP อื่นๆ (ตัวอย่าง: Cursor):

คุณสามารถกำหนดค่าไคลเอนต์ MCP ของคุณให้ใช้ OAuth โดยไม่ต้องรวมคีย์ API Tavily ใน URL ตัวอย่างเช่น ใน mcp.json ของคุณ:

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx mcp-remote https://mcp.tavily.com/mcp",
      "env": {}
    }
  }
}

หากคุณต้องการล้างข้อมูลรับรอง OAuth ที่เก็บไว้และยืนยันตัวตนใหม่ ให้รัน:

rm -rf ~/.mcp-auth

หมายเหตุ:

  • การยืนยันตัวตนแบบ OAuth เป็นทางเลือก คุณยังสามารถใช้การยืนยันตัวตนด้วยคีย์ API ได้ตลอดเวลาโดยรวมคีย์ API Tavily ของคุณในพารามิเตอร์คิวรี URL (?tavilyApiKey=...) หรือโดยการตั้งค่าในส่วนหัว Authorization ตามที่อธิบายไว้ข้างต้น

การเลือกคีย์ API ที่ใช้สำหรับ OAuth

หลังจากการยืนยันตัวตน OAuth สำเร็จ คุณสามารถควบคุมได้ว่าจะใช้คีย์ API ใดโดยตั้งชื่อว่า mcp_auth_default:

  • หากคุณตั้งค่าคีย์ชื่อ mcp_auth_default ใน บัญชีส่วนตัว ของคุณ คีย์นั้นจะถูกใช้สำหรับขั้นตอนการยืนยันตัวตน
  • หากคุณเป็นส่วนหนึ่งของ ทีม ที่มีคีย์ชื่อ mcp_auth_default คีย์นั้นจะถูกใช้สำหรับขั้นตอนการยืนยันตัวตน
  • หากคุณมี ทั้ง คีย์ส่วนตัวและคีย์ทีมที่ชื่อ mcp_auth_default คีย์ส่วนตัวจะถูกจัดลำดับความสำคัญก่อน
  • หากไม่มีการตั้งค่าคีย์ mcp_auth_default คีย์ default ในบัญชีส่วนตัวของคุณจะถูกใช้ หากไม่มีการตั้งค่าคีย์ default คีย์แรกที่พร้อมใช้งานจะถูกใช้

MCP ในเครื่อง

ข้อกำหนดเบื้องต้น 🔧

ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมี:

  • คีย์ API Tavily
    • หากคุณไม่มีคีย์ API Tavily คุณสามารถสมัครบัญชีฟรีได้ ที่นี่
  • Claude Desktop หรือ Cursor
  • Node.js (v20 หรือสูงกว่า)
    • คุณสามารถตรวจสอบการติดตั้ง Node.js ของคุณได้โดยการรัน:
      • node --version
  • Git ติดตั้งแล้ว (จำเป็นเฉพาะเมื่อใช้วิธีการติดตั้งแบบ Git)
    • บน macOS: brew install git
    • บน Linux:
      • Debian/Ubuntu: sudo apt install git
      • RedHat/CentOS: sudo yum install git
    • บน Windows: ดาวน์โหลด Git for Windows

การรันด้วย NPX

npx -y tavily-mcp@latest

การกำหนดค่าพารามิเตอร์เริ่มต้น ⚙️

คุณสามารถตั้งค่าพารามิเตอร์เริ่มต้นสำหรับเครื่องมือ tavily-search ได้โดยใช้ตัวแปรสภาพแวดล้อม DEFAULT_PARAMETERS ซึ่งช่วยให้คุณกำหนดค่าพฤติกรรมการค้นหาเริ่มต้นโดยไม่ต้องระบุพารามิเตอร์เหล่านี้ในทุกคำขอ

ตัวอย่างการกำหนดค่า

export DEFAULT_PARAMETERS='{"include_images": true}'

ตัวอย่างการใช้งานจากไคลเอนต์

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "DEFAULT_PARAMETERS": "{\"include_images\": true, \"max_results\": 15, \"search_depth\": \"advanced\"}"
      }
    }
  }
}

การระบุผู้ใช้ปลายทาง (ทางเลือก)

คุณสามารถระบุผู้ใช้ปลายทางที่คำขอถูกส่งในนามของเขาได้โดยการตั้งค่าตัวแปรสภาพแวดล้อม TAVILY_HUMAN_ID เมื่อตั้งค่าแล้ว Tavily MCP จะส่งต่อเป็นส่วนหัว X-Human-Id ในทุกการเรียก API ทำให้สามารถวิเคราะห์ต่อผู้ใช้ได้

นี่เป็น ทางเลือกอย่างสมบูรณ์ — ปล่อยว่างไว้และพฤติกรรมจะไม่เปลี่ยนแปลง

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "TAVILY_HUMAN_ID": "your-user-id"
      }
    }
  }
}

หมายเหตุความเป็นส่วนตัว: Tavily แฮช human_id ฝั่งเซิร์ฟเวอร์ (SHA-256) ก่อนจัดเก็บ ดังนั้นค่าดิบจะไม่ถูกบันทึกอย่างถาวร ถึงกระนั้นก็ตาม ควรเลือกใช้ตัวระบุที่ไม่เปิดเผยตัวตน (เช่น ID ผู้ใช้ภายใน) มากกว่า PII ดิบอย่างอีเมลเมื่อเป็นไปได้

กิตติกรรมประกาศ ✨