Tavily
Tavily
Tavily MCP 서버는 Tavily AI의 고급 검색 및 데이터 추출 기능을 Model Context Protocol 표준에 통합하여, AI 어시스턴트가 실시간 웹 정보에 접근하고 콘텐츠를 추출할 수 있도록 하는 서버 구현체입니다. 이 서버는 AI 모델이 검색 엔진을 통해 최신 정보를 얻고, 웹 콘텐츠를 효과적으로 분석할 수 있게 합니다.
특징
- 실시간 웹 검색: 최신 웹 정보를 실시간으로 검색하고 접근
- 스마트 콘텐츠 추출: 웹페이지에서 관련 콘텐츠를 AI 기반으로 추출
- 도메인 특화 검색: 특정 도메인이나 사이트에 대한 맞춤형 검색 수행
- 뉴스 기사 검색: 최신 뉴스 검색 및 관련 콘텐츠 추출
- 직접 응답 생성: 질문에 대한 직접적인 응답 제공
- 사이트 필터링: 포함/제외할 도메인 설정 가능
- 최신성 제어: 특정 기간 내의 콘텐츠만 검색 가능
- 결과 개수 제한: 반환할 검색 결과 수 조절 가능
API
리소스
- SearchResults: 웹 검색 결과 정보
- NewsResults: 뉴스 검색 결과
- ExtractedContent: 웹페이지에서 추출된 콘텐츠
- DirectAnswer: 질문에 대한 직접 응답
도구
tavily-search
Tavily AI를 사용하여 웹 검색을 수행합니다.
- 입력:
- query: 검색할 키워드나 문구
- search_depth: 검색 깊이(기본값: "basic", 선택사항: "advanced")
- include_domains: 검색에 포함할 도메인 목록(선택)
- exclude_domains: 검색에서 제외할 도메인 목록(선택)
- max_results: 반환할 최대 결과 수(선택)
- include_answer: 직접 답변 포함 여부(선택)
- include_raw_content: 원시 콘텐츠 포함 여부(선택)
- include_images: 이미지 정보 포함 여부(선택)
- max_age: 콘텐츠 최대 기간(일 단위, 선택)
- search_type: 검색 유형("news", "web" 등, 선택)
tavily-extract
특정 URL에서 콘텐츠를 추출합니다.
- 입력:
- url: 콘텐츠를 추출할 웹페이지 URL
- summarize: 콘텐츠 요약 여부(선택)
- extract_text: 텍스트 추출 여부(선택)
- include_images: 이미지 정보 포함 여부(선택)
- extract_metadata: 메타데이터 추출 여부(선택)
사용 방법
설치 및 구성
- Tavily AI 계정 생성 및 API 키 발급
- Tavily Dashboard에서 API 키 발급
- NPX를 통한 설치 및 실행
npx -y tavily-mcp@0.1.4 - Claude Desktop 구성 파일에 추가
{ "mcpServers": { "tavily-mcp": { "command": "npx", "args": ["-y", "tavily-mcp@0.1.4"], "env": { "TAVILY_API_KEY": "your-api-key-here" } } } } - Cursor, Cline 등 다른 MCP 클라이언트에도 유사한 방식으로 설정 가능
사용 예시
- 일반 웹 검색: "최신 AI 기술 동향에 대해 검색해줘"
- 뉴스 검색: "지난 1주일 동안의 AI 스타트업 관련 뉴스 기사를 찾아줘"
- 특정 사이트 검색: "microsoft.com 도메인에서 Azure OpenAI 서비스에 대한 정보를 찾아줘"
- 콘텐츠 추출: "이 URL에서 주요 내용을 추출하고 요약해줘"
- 도메인 필터링: "인공지능에 대한 학술 사이트만 검색해서 정보를 찾아줘"
주의사항
- API 키는 민감한 정보이므로 안전하게 관리해야 함
- Tavily AI 서비스 이용 약관 및 제한 사항을 확인해야 함
- 대량의 API 호출은 요금이 발생할 수 있으므로 사용량을 모니터링해야 함
- 서버 구성 후 클라이언트 애플리케이션을 완전히 재시작해야 함