tavily-ai/tavily-mcp

Tavily MCP 서버는 무엇인가요?

Tavily MCP는 가벼운 크기의 자체 호스팅(또는 원격 호스팅) 가능한 MCP(Model Context Protocol) 서버로, AI 에이전트가 네 가지 웹 지식 도구에 접근할 수 있도록 합니다:

도구	기능	일반적인 AI 사용 사례
tavily‑search	실시간 웹 검색(Google 유사)	모델이 응답을 생성하는 동안 최신 사실, 뉴스 또는 참고 자료를 검색
tavily‑extract	URL에서 주요 텍스트, 이미지 및 메타데이터를 추출	페이지 요약, 내용에 대한 질문 답변, 또는 하류 모델에 텍스트 제공
tavily‑map	사이트를 크롤링하고 구조화된 사이트맵(페이지, 계층, 링크)을 반환	문서화 사이트의 지식 그래프 구축 또는 챗봇을 위한 탐색 안내 생성
tavily‑crawl	도메인을 체계적으로 탐색하여 발견된 URL 목록과 그 내용을 반환	미세 조정, RAG 인덱싱 또는 대량 분석을 위한 코퍼스 수집

이 서버는 Model Context Protocol를 따릅니다. 이는 LLM 기반 도구(Claude Code, Cursor 등)가 외부 서비스를 내장 함수처럼 호출할 수 있도록 하는 표준입니다. 클라이언트에 Tavily MCP 서버를 추가하면, 모델은 간단한 JSON 요청으로 네 가지 도구 중 하나를 호출할 수 있습니다.

---

어떻게 실행하나요?

원격(Тavily에서 호스팅)

• 설치 필요 없음 – 클라이언트를 https://mcp.tavily.com/mcp/로 지정하고 Tavily API 키를 URL에 (?tavilyApiKey=…) 또는 Authorization: Bearer … 헤더를 통해 제공하세요.
• 또한 DEFAULT_PARAMETERS 헤더를 통해 JSON 객체를 전송하여 모든 요청에 대한 기본 검색 옵션(예: "include_images":true,"max_results":10)을 설정할 수 있습니다.

로컬(자신이 실행)

1. Node 20 이상을 설치하세요.
2. NPX로 패키지를 직접 실행하세요:

   npx -y tavily-mcp@latest
   

3. MCP 클라이언트 구성에서 API 키와 선택적 환경 변수(아래 참조)를 제공하세요.

---

관심 있을 만한 구성 옵션들

환경 변수 / 헤더	목적	예시
TAVILY_API_KEY	모든 도구 호출에 대한 인증	TAVILY_API_KEY=sk_…
DEFAULT_PARAMETERS	기본 검색 파라미터(JSON 형식, 이미지 포함 여부, 깊이, 결과 수 등)	"{\"include_images\":true,\"search_depth\":\"advanced\",\"max_results\":15}"
TAVILY_HUMAN_ID	선택적 불투명한 사용자 식별자; X‑Human‑Id로 전송(서버 측에서 해시 처리)	TAVILY_HUMAN_ID=12345
OAuth 흐름	URL에 API 키 대신 OAuth 프로세스를 사용할 수 있습니다(클라이언트 인스펙터, Cursor 등에서 지원). 서버는 클라이언트가 자동으로 사용할 수 있는 액세스 토큰을 발급합니다.

---

인기 있는 AI 코딩 보조 도구에 연결하는 방법

Claude Code (Anthropic)

# URL에 API 키 포함
claude mcp add --transport http tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-key>

# 또는 OAuth 흐름 사용(키를 URL에 포함하지 않음)
claude mcp add --transport http tavily https://mcp.tavily.com/mcp

추가 후 claude를 실행하고 /mcp를 입력한 후 프롬프트를 따라 인증을 완료하세요. --scope user를 추가하면 서버가 모든 Claude 프로젝트에서 사용 가능해집니다.

Cursor (AI 중심 IDE)

README의 "Cursor에 추가" 버튼을 클릭한 후 생성된 mcp.json을 편집하여 API 키를 삽입하세요:

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

URL에서 키를 생략함으로써 OAuth 버전도 사용할 수 있습니다.

---

누가 이 도구를 사용할 수 있을까요?

대상	왜 중요한가
LLM 개발자 – 최신 웹 정보가 필요한 에이전트를 개발하는 사람들은 tavily-search를 모델에서 직접 호출할 수 있어, 맞춤형 크롤링 코드를 작성할 필요가 없습니다.
RAG 엔지니어 – 사이트에서 최신 문서를 빠르게 추출하여 벡터 스토어에 공급하고 싶은 사람들은 tavily-crawl/tavily-map을 통해 미리 준비된 코퍼스를 얻을 수 있습니다.
생산성 도구 제작자 (예: VS Code 확장, AI 노트북) – "웹 검색" 또는 "페이지 요약" 기능을 내장 명령어로 추가하고 싶은 사람
연구자 – LLM이 실시간 데이터와 어떻게 상호작용하는지 탐구하는 사람들은 인프라를 관리하지 않고도 실험할 수 있도록 원격 서버를 제공합니다.

---

빠른 "안녕, 세계" 요청 예시 (MCP 클라이언트에서 사용하는 JSON 형식)

{
  "tool": "tavily-search",
  "arguments": {
    "query": "최신 GPT‑4 릴리스 노트",
    "max_results": 3,
    "include_images": false
  }
}

서버는 title, url, snippet, 그리고 요청 시 image_url을 포함한 결과 객체 목록을 반환합니다.

---

더 알아보기

• 튜토리얼 – 지식 그래프 어시스턴트 만들기 (Tavily MCP와 Neo4j 결합)
• 튜토리얼 – 코딩 보조 도구를 웹에 연결하기 (Tavily MCP와 Cline VS Code 확장 통합)
• Model Context Protocol 사양(기반 API 계약)
• Anthropic의 Claude Code 문서(사용자 정의 MCP 서버 추가 방법)

---

TL;DR

Tavily MCP는 웹 검색, 추출, 맵핑, 크롤링을 표준 MCP 도구로 전환하는 즉시 사용 가능한 서버입니다. 단일 npx 명령어로 로컬에서 실행하거나 Tavily의 호스팅 엔드포인트에 연결할 수 있으며, Claude Code, Cursor 등과 같은 MCP 호환 LLM 클라이언트가 이 도구들을 내장 함수처럼 호출할 수 있습니다. 이는 AI 에이전트가 맞춤형 크롤러 없이도 신뢰할 수 있고 실시간으로 오픈 웹에 접근할 수 있도록 합니다.