Tavily

공식

AI 검색 및 콘텐츠 추출을 위한 공식 Tavily MCP 서버로, MCP 클라이언트에 웹 검색, 크롤링, 추출 도구를 제공합니다.

GitHub

2.2k

Tavily MCP(으)로 무엇을 할 수 있나요?

실시간 웹 검색 — tavily-search를 사용하여 최신 정보, 뉴스 또는 답변을 요청하세요.
URL에서 구조화된 콘텐츠 추출 — tavily-extract로 특정 웹 페이지에서 깔끔하고 관련성 높은 데이터를 가져오세요.
웹사이트 구조 매핑 — tavily-map을 통해 도메인의 페이지와 섹션 개요를 확인하세요.
체계적인 웹사이트 크롤링 — tavily-crawl을 사용하여 시작 URL에서 연결된 여러 페이지를 탐색하세요.

문서

Tavily MCP 서버

npm

Tavily MCP 서버는 다음을 제공합니다:

검색, 추출, 매핑, 크롤링 도구
tavily-search 도구를 통한 실시간 웹 검색 기능
tavily-extract 도구를 통한 웹 페이지의 지능형 데이터 추출
웹사이트의 구조화된 맵을 생성하는 강력한 웹 매핑 도구
웹사이트를 체계적으로 탐색하는 웹 크롤러

📚 유용한 자료

Tavily MCP와 Neo4j MCP 서버를 결합하는 튜토리얼
VS Code에서 Tavily MCP와 Cline을 통합하는 튜토리얼

원격 MCP 서버

로컬에서 실행하는 대신 Tavily의 원격 MCP 서버에 직접 연결하세요. 로컬 설치나 구성 없이도 원활한 경험을 제공합니다.

Tavily API 키와 함께 원격 MCP 서버 URL을 사용하기만 하면 됩니다:

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

tavily.com에서 Tavily API 키를 받으세요.

또는 MCP 클라이언트가 지원하는 경우 Authorization 헤더를 통해 API 키를 전달할 수 있습니다:

Authorization: Bearer <your-api-key>

참고: 원격 MCP를 사용할 때, 원하는 기본값을 포함한 JSON 객체를 담은 DEFAULT_PARAMETERS 헤더를 포함시켜 모든 요청에 대한 기본 매개변수를 지정할 수 있습니다. 예시:

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

Claude Code에 연결

Claude Code는 Anthropic의 공식 Claude용 CLI 도구입니다. claude mcp add 명령을 사용하여 Tavily MCP 서버를 추가할 수 있습니다. 인증 방법은 두 가지입니다:

옵션 1: URL에 API 키 포함

URL에 API 키를 직접 전달하세요. <your-api-key>를 실제 Tavily API 키로 교체하세요:

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

옵션 2: OAuth 인증 흐름

URL에 API 키 없이 서버를 추가하세요:

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

추가한 후에는 인증 흐름을 완료해야 합니다:

claude을 실행하여 Claude Code 시작
/mcp을 입력하여 MCP 서버 관리 열기
Tavily 서버를 선택하고 인증 프로세스 완료

팁: 두 명령어 중 하나에 --scope user을 추가하면 Tavily MCP 서버를 모든 프로젝트에서 전역적으로 사용할 수 있습니다:

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

구성이 완료되면 Tavily 검색, 추출, 매핑, 크롤링 도구에 접근할 수 있습니다.

Cursor에 연결

⬆️ Cursor에 추가 ⬆️ 버튼을 클릭하면 대부분의 작업이 자동으로 진행되지만, API-KEY를 추가하기 위해 구성을 편집해야 합니다. Tavily API 키는 여기에서 받을 수 있습니다.

버튼을 클릭하면 Cursor로 리디렉션됩니다 ...

1단계

설치 버튼을 클릭하세요

2단계

MCP가 설치된 것을 볼 수 있습니다. 파란색 슬라이드가 켜져 있지 않다면 수동으로 켜세요. 또한 자신의 Tavily API 키를 포함하도록 구성을 편집해야 합니다.

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

원격 MCP 서버 OAuth 흐름

Tavily 원격 MCP 서버는 안전한 OAuth 인증을 지원하여 호환되는 클라이언트와 원활하게 연결하고 인증할 수 있습니다.

OAuth 인증 설정 방법

A. MCP Inspector 사용:

MCP Inspector를 열고 "Open Auth Settings"를 클릭하세요.
OAuth 흐름을 선택하고 다음 단계를 완료하세요:
1. 메타데이터 검색
2. 클라이언트 등록
3. 인증 준비
4. 인증 요청 및 인증 코드 획득
5. 토큰 요청
6. 인증 완료

완료되면 Tavily 원격 MCP 서버에 인증된 요청을 안전하게 보낼 수 있는 액세스 토큰을 받게 됩니다.

B. 다른 MCP 클라이언트 사용 (예: Cursor):

URL에 Tavily API 키를 포함하지 않고 OAuth를 사용하도록 MCP 클라이언트를 구성할 수 있습니다. 예를 들어, mcp.json에서:

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

저장된 OAuth 자격 증명을 지우고 재인증해야 하는 경우 다음을 실행하세요:

rm -rf ~/.mcp-auth

참고:

OAuth 인증은 선택 사항입니다. 위에서 설명한 대로 URL 쿼리 매개변수(?tavilyApiKey=...)에 Tavily API 키를 포함하거나 Authorization 헤더에 설정하여 언제든지 API 키 인증을 계속 사용할 수 있습니다.

OAuth에 사용할 API 키 선택

OAuth 인증 성공 후, mcp_auth_default이라는 이름을 지정하여 어떤 API 키를 사용할지 제어할 수 있습니다:

개인 계정에 mcp_auth_default이라는 키를 설정하면 해당 키가 인증 흐름에 사용됩니다.
mcp_auth_default이라는 키를 가진 팀에 속해 있다면 해당 키가 인증 흐름에 사용됩니다.
개인 키와 팀 키 모두 mcp_auth_default이라는 이름으로 가지고 있다면 개인 키가 우선됩니다.
mcp_auth_default 키가 설정되지 않은 경우 개인 계정의 default 키가 사용됩니다. default 키도 설정되지 않은 경우 사용 가능한 첫 번째 키가 사용됩니다.

로컬 MCP

사전 준비 사항 🔧

시작하기 전에 다음 사항을 확인하세요:

Tavily API 키
- Tavily API 키가 없다면 여기에서 무료 계정에 가입할 수 있습니다.
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

기본 매개변수 구성 ⚙️

DEFAULT_PARAMETERS 환경 변수를 사용하여 tavily-search 도구의 기본 매개변수 값을 설정할 수 있습니다. 이를 통해 모든 요청에서 이러한 매개변수를 지정하지 않고도 기본 검색 동작을 구성할 수 있습니다.

구성 예시

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는 모든 API 호출에서 이를 X-Human-Id 헤더로 전달하여 사용자별 분석을 가능하게 합니다.

이는 완전히 선택 사항이며, 설정하지 않으면 동작이 변경되지 않습니다.

{
  "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)를 선호하세요.

감사의 말 ✨

MCP 사양을 제공한 Model Context Protocol
Claude Desktop을 제공한 Anthropic