Tavily

Máy chủ Tavily MCP

Máy chủ Tavily MCP cung cấp:

• các công cụ tìm kiếm, trích xuất, lập bản đồ, thu thập dữ liệu
• Khả năng tìm kiếm web thời gian thực thông qua công cụ tavily-search
• Trích xuất dữ liệu thông minh từ các trang web qua công cụ tavily-extract
• Công cụ lập bản đồ web mạnh mẽ tạo ra bản đồ có cấu trúc của trang web
• Trình thu thập dữ liệu web khám phá trang web một cách có hệ thống

📚 Tài nguyên hữu ích

• Hướng dẫn về cách kết hợp Tavily MCP với máy chủ Neo4j MCP
• Hướng dẫn về cách tích hợp Tavily MCP với Cline trong VS Code

Máy chủ MCP từ xa

Kết nối trực tiếp đến máy chủ MCP từ xa của Tavily thay vì chạy cục bộ. Điều này mang lại trải nghiệm liền mạch mà không yêu cầu cài đặt hoặc cấu hình cục bộ.

Chỉ cần sử dụng URL máy chủ MCP từ xa với khóa API Tavily của bạn:

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

Nhận khóa API Tavily của bạn từ tavily.com.

Ngoài ra, bạn có thể truyền khóa API của mình qua tiêu đề Ủy quyền nếu máy khách MCP hỗ trợ điều này:

Authorization: Bearer <your-api-key>

Lưu ý: Khi sử dụng MCP từ xa, bạn có thể chỉ định các tham số mặc định cho tất cả các yêu cầu bằng cách bao gồm tiêu đề DEFAULT_PARAMETERS chứa một đối tượng JSON với các giá trị mặc định mong muốn của bạn. Ví dụ:

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

Kết nối với Claude Code

Claude Code là công cụ CLI chính thức của Anthropic dành cho Claude. Bạn có thể thêm máy chủ Tavily MCP bằng lệnh claude mcp add. Có hai cách để xác thực:

Tùy chọn 1: Khóa API trong URL

Truyền trực tiếp khóa API của bạn trong URL. Thay thế <your-api-key> bằng khóa API Tavily thực tế của bạn:

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

Tùy chọn 2: Luồng xác thực OAuth

Thêm máy chủ mà không có khóa API trong URL:

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

Sau khi thêm, bạn sẽ cần hoàn tất luồng xác thực:

1. Chạy claude để khởi động Claude Code
2. Nhập /mcp để mở quản lý máy chủ MCP
3. Chọn máy chủ Tavily và hoàn tất quá trình xác thực

Mẹo: Thêm --scope user vào một trong hai lệnh để làm cho máy chủ Tavily MCP khả dụng trên toàn cầu trong tất cả các dự án của bạn:

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

Sau khi được cấu hình, bạn sẽ có quyền truy cập vào các công cụ tìm kiếm, trích xuất, lập bản đồ và thu thập dữ liệu của Tavily.

Kết nối với Cursor

Nhấp vào nút ⬆️ Thêm vào Cursor ⬆️, thao tác này sẽ thực hiện hầu hết công việc cho bạn nhưng bạn vẫn cần chỉnh sửa cấu hình để thêm KHÓA API của mình. Bạn có thể lấy khóa API Tavily tại đây.

khi bạn nhấp vào nút, bạn sẽ được chuyển hướng đến Cursor ...

Bước 1

Nhấp vào nút cài đặt

Bước 2

Bạn sẽ thấy MCP hiện đã được cài đặt, nếu thanh trượt màu xanh chưa được bật, hãy bật nó lên theo cách thủ công. Bạn cũng cần chỉnh sửa cấu hình để bao gồm khóa API Tavily của riêng bạn.

Bước 3

Sau đó, bạn sẽ được chuyển hướng đến tệp mcp.json của mình, nơi bạn phải thêm your-api-key.

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

Luồng OAuth của Máy chủ MCP từ xa

Máy chủ Tavily MCP từ xa hỗ trợ xác thực OAuth an toàn, cho phép bạn kết nối và ủy quyền một cách liền mạch với các máy khách tương thích.

Cách thiết lập xác thực OAuth

A. Sử dụng MCP Inspector:

• Mở MCP Inspector và nhấp vào "Mở Cài đặt Xác thực".
• Chọn luồng OAuth và hoàn thành các bước sau:
  1. Khám phá siêu dữ liệu
  2. Đăng ký máy khách
  3. Chuẩn bị ủy quyền
  4. Yêu cầu ủy quyền và lấy mã ủy quyền
  5. Yêu cầu mã thông báo
  6. Xác thực hoàn tất

Sau khi hoàn tất, bạn sẽ nhận được mã thông báo truy cập cho phép bạn thực hiện các yêu cầu đã xác thực một cách an toàn đến Máy chủ Tavily MCP từ xa.

B. Sử dụng các Máy khách MCP khác (Ví dụ: Cursor):

Bạn có thể cấu hình máy khách MCP của mình để sử dụng OAuth mà không cần bao gồm khóa API Tavily trong URL. Ví dụ: trong mcp.json của bạn:

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

Nếu bạn cần xóa thông tin xác thực OAuth đã lưu trữ và xác thực lại, hãy chạy:

rm -rf ~/.mcp-auth

Lưu ý:

• Xác thực OAuth là tùy chọn. Bạn vẫn có thể sử dụng xác thực khóa API bất kỳ lúc nào bằng cách bao gồm khóa API Tavily của bạn trong tham số truy vấn URL (?tavilyApiKey=...) hoặc bằng cách đặt nó trong tiêu đề Authorization, như đã mô tả ở trên.

Chọn khóa API nào được sử dụng cho OAuth

Sau khi xác thực OAuth thành công, bạn có thể kiểm soát khóa API nào được sử dụng bằng cách đặt tên cho nó là mcp_auth_default:

• Nếu bạn đặt một khóa có tên mcp_auth_default trong tài khoản cá nhân của mình, khóa đó sẽ được sử dụng cho luồng xác thực.
• Nếu bạn là thành viên của một nhóm có khóa tên mcp_auth_default, khóa đó sẽ được sử dụng cho luồng xác thực.
• Nếu bạn có cả khóa cá nhân và khóa nhóm tên mcp_auth_default, khóa cá nhân sẽ được ưu tiên.
• Nếu không có khóa mcp_auth_default nào được đặt, khóa default trong tài khoản cá nhân của bạn sẽ được sử dụng. Nếu không có khóa default nào được đặt, khóa khả dụng đầu tiên sẽ được sử dụng.

MCP cục bộ

Điều kiện tiên quyết 🔧

Trước khi bắt đầu, hãy đảm bảo bạn có:

• Khóa API Tavily
  • Nếu bạn chưa có khóa API Tavily, bạn có thể đăng ký tài khoản miễn phí tại đây
• Claude Desktop hoặc Cursor
• Node.js (v20 trở lên)
  • Bạn có thể xác minh cài đặt Node.js của mình bằng cách chạy:
    • node --version
• Git đã được cài đặt (chỉ cần nếu sử dụng phương pháp cài đặt Git)
  • Trên macOS: brew install git
  • Trên Linux:
    • Debian/Ubuntu: sudo apt install git
    • RedHat/CentOS: sudo yum install git
  • Trên Windows: Tải xuống Git cho Windows

Chạy với NPX

npx -y tavily-mcp@latest 

Cấu hình tham số mặc định ⚙️

Bạn có thể đặt giá trị tham số mặc định cho công cụ tavily-search bằng cách sử dụng biến môi trường DEFAULT_PARAMETERS. Điều này cho phép bạn cấu hình hành vi tìm kiếm mặc định mà không cần chỉ định các tham số này trong mỗi yêu cầu.

Ví dụ cấu hình

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

Ví dụ sử dụng từ Máy khách

{
  "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\"}"
      }
    }
  }
}

Xác định người dùng cuối (Tùy chọn)

Bạn có thể tùy chọn xác định người dùng cuối mà các yêu cầu được thực hiện thay mặt bằng cách đặt biến môi trường TAVILY_HUMAN_ID. Khi được đặt, Tavily MCP sẽ chuyển tiếp nó dưới dạng tiêu đề X-Human-Id trên mỗi lệnh gọi API, cho phép phân tích trên mỗi người dùng.

Điều này hoàn toàn tùy chọn — để trống và hành vi sẽ không thay đổi.

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

Lưu ý về quyền riêng tư: Tavily băm human_id ở phía máy chủ (SHA-256) trước khi lưu trữ, vì vậy giá trị thô không bao giờ được lưu giữ. Mặc dù vậy, hãy ưu tiên các định danh mờ (ví dụ: ID người dùng nội bộ) hơn là PII thô như email khi có thể.

Lời cảm ơn ✨

• Model Context Protocol cho đặc tả MCP
• Anthropic cho Claude Desktop