Tavily Search MCP 서버

LLM에 최적화된 검색 기능을 제공하는 Tavily Search API를 통합한 MCP 서버 구현입니다.

특징

• 웹 검색: LLM에 최적화된 웹 검색을 수행하고 검색 깊이, 주제, 시간 범위를 제어합니다.
• 콘텐츠 추출: 검색 결과에서 가장 관련성 있는 콘텐츠를 추출하여 품질과 크기를 최적화합니다.
• 선택 기능: 이미지, 이미지 설명, LLM에서 생성된 짧은 답변, 원시 HTML 콘텐츠를 포함합니다.
• 도메인 필터링: 검색 결과에 특정 도메인을 포함하거나 제외합니다.

도구

• 타빌리_서치
  • Tavily Search API를 사용하여 웹 검색을 실행합니다.
  • 입력:
    • query (문자열, 필수): 검색 쿼리.
    • search_depth (문자열, 선택 사항): "기본" 또는 "고급"(기본값: "기본").
    • topic (문자열, 선택 사항): "일반" 또는 "뉴스"(기본값: "일반").
    • days (숫자, 선택 사항): 뉴스 검색을 위한 지난 일 수(기본값: 3).
    • time_range (문자열, 선택 사항): 시간 범위 필터("일", "주", "월", "년" 또는 "일", "수", "월", "년").
    • max_results (숫자, 선택 사항): 최대 결과 수(기본값: 5).
    • include_images (부울, 선택 사항): 관련 이미지를 포함합니다(기본값: false).
    • include_image_descriptions (부울, 선택 사항): 이미지에 대한 설명을 포함합니다(기본값: false).
    • include_answer (부울, 선택 사항): LLM에서 생성된 짧은 답변을 포함합니다(기본값: false).
    • include_raw_content (부울, 선택 사항): 원시 HTML 콘텐츠를 포함합니다(기본값: false).
    • include_domains (문자열[], 선택 사항): 포함할 도메인입니다.
    • exclude_domains (문자열[], 선택 사항): 제외할 도메인입니다.

설정 가이드 🚀

1. 필수 조건

• Claude Desktop 이 컴퓨터에 설치되었습니다.
• Tavily API 키: a. Tavily API 계정 에 가입합니다. b. 플랜을 선택합니다(무료 티어 이용 가능). c. Tavily 대시보드에서 API 키를 생성합니다.

2. 설치

1. 컴퓨터의 어딘가에 이 저장소를 복제하세요.지엑스피1
2. 종속성을 설치하고 프로젝트를 빌드합니다.
   cd tavily-search-mcp-server
   npm install
   npm run build

3. Claude Desktop과의 통합

1. Claude Desktop 구성 파일을 엽니다.
   # On Mac: ~/Library/Application\ Support/Claude/claude_desktop_config.json # On Windows: %APPDATA%\Claude\claude_desktop_config.json
2. npm 이나 docker 사용하여 서버를 실행할지 여부에 따라 config의 mcpServers 개체에 다음 중 하나를 추가합니다.옵션 A: NPM(stdio 전송) 사용
   { "mcpServers": { "tavily-search-server": { "command": "node", "args": [ "/Users/<username>/<FULL_PATH...>/tavily-search-mcp-server/dist/index.js" ], "env": { "TAVILY_API_KEY": "your_api_key_here" } } } }
   옵션 B: NPM(SSE 전송) 사용
   { "mcpServers": { "tavily-search-server": { "command": "node", "args": [ "/Users/<username>/<FULL_PATH...>/tavily-search-mcp-server/dist/sse.js" ], "env": { "TAVILY_API_KEY": "your_api_key_here" }, "port": 3001 } } }
   옵션 C: Docker 사용
   { "mcpServers": { "tavily-search-server": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "TAVILY_API_KEY", "-v", "/Users/<username>/<FULL_PATH...>/tavily-search-mcp-server:/app", "tavily-search-mcp-server" ], "env": { "TAVILY_API_KEY": "your_api_key_here" } } } }
3. 중요 단계:
   • /Users/<username>/<FULL_PATH...>/tavily-search-mcp-server 저장소를 복제한 실제 전체 경로로 바꾸세요.
   • env 섹션에 Tavily API 키를 추가하세요. API 키와 같은 비밀 정보는 환경 변수로 저장하는 것이 좋습니다.
   • Windows에서도 경로에 슬래시( / )를 꼭 사용하세요.
   • docker를 사용하는 경우 docker build -t tavily-search-mcp-server:latest .
4. 변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.

Smithery를 통해 설치

Smithery를 통해 Tavily Search for Claude Desktop을 자동으로 설치하려면:

환경 설정(npm용)

1. .env.example``.env 로 복사합니다.
   cp .env.example .env
2. 실제 Tavily API 키로 .env 파일을 업데이트하세요.
   TAVILY_API_KEY=your_api_key_here
   참고: 실제 API 키를 버전 관리 시스템에 커밋하지 마세요. 보안상의 이유로 .env 파일은 git에서 무시됩니다.

NPM으로 실행

Node.js를 사용하여 서버를 시작합니다.

SSE 운송의 경우:

Docker로 실행

1. Docker 이미지를 빌드합니다(아직 빌드하지 않았다면):
   docker build -t tavily-search-mcp-server:latest .
2. 다음을 사용하여 Docker 컨테이너를 실행합니다.stdio 전송의 경우:
   docker run -it --rm -e TAVILY_API_KEY="your_api_key_here" tavily-search-mcp-server:latest
   SSE 운송의 경우:
   docker run -it --rm -p 3001:3001 -e TAVILY_API_KEY="your_api_key_here" -e TRANSPORT="sse" tavily-search-mcp-server:latest
   쉘의 환경 변수를 직접 활용할 수도 있는데, 이는 보안 측면에서 더 안전한 방법입니다.
   docker run -it --rm -p 3001:3001 -e TAVILY_API_KEY=$TAVILY_API_KEY -e TRANSPORT="sse" tavily-search-mcp-server:latest
   참고: 두 번째 명령은 -e TAVILY_API_KEY=$TAVILY_API_KEY 사용하여 TAVILY_API_KEY 환경 변수 값을 Docker 컨테이너에 전달하는 권장 방식을 보여줍니다. 이렇게 하면 API 키가 명령 기록에 표시되지 않으며, 명령에 하드코딩된 비밀보다 일반적으로 선호됩니다.
3. 도커 컴포즈 사용하기달리다:
   docker compose up -d
   서버를 중지하려면:
   docker compose down

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.