Skip to main content
Glama
Tavily Search MCP

Tavily Search MCP

by whfzdxhst

Tavily Search MCP

Tavily Search MCP는 Streamable HTTP 기반의 MCP 서비스로, Tavily의 웹 검색 및 웹 콘텐츠 추출 기능을 MCP 도구로 캡슐화합니다.

기능

  • web_search: 검색 키워드를 기반으로 웹 검색을 수행합니다.

  • web_fetch: 웹 URL에서 읽을 수 있는 텍스트 콘텐츠를 추출합니다.

Related MCP server: tavily-mcp

환경 요구 사항

  • Python 3.11+

  • Tavily API Key

  • streamable_http를 지원하는 MCP 클라이언트

설치

먼저 자신의 Python 가상 환경을 생성하고 활성화한 후, 의존성 및 현재 프로젝트를 설치합니다:

python -m pip install -r requirements.txt
python -m pip install -e .

환경 변수 템플릿을 복사합니다:

cp .env.example .env

.env 파일에 구성을 입력합니다:

TAVILY_API_KEY=tvly-your-api-key
MCP_SERVER_HOST=127.0.0.1
MCP_SERVER_PORT=21029
MCP_SERVER_PATH=/mcp
MCP_ALLOWED_HOSTS=127.0.0.1,127.0.0.1:21029,localhost,localhost:21029
MCP_ALLOWED_ORIGINS=*

서버에 배포하는 경우, MCP_SERVER_HOST를 0.0.0.0으로 설정하고 공개 도메인 또는 접속 호스트 이름을 MCP_ALLOWED_HOSTS에 추가하세요.

서비스 시작

python -m tavily_search_mcp.server

기본 로컬 MCP 주소:

http://127.0.0.1:21029/mcp

건강 검사:

curl http://127.0.0.1:21029/health

테스트 클라이언트

MCP 도구 목록 표시:

python -m tavily_search_mcp.client --url http://127.0.0.1:21029/mcp list-tools

웹 검색 호출:

python -m tavily_search_mcp.client --url http://127.0.0.1:21029/mcp web-search "Tavily Python SDK" --max-results 2

웹 콘텐츠 추출 호출:

python -m tavily_search_mcp.client --url http://127.0.0.1:21029/mcp web-fetch "https://docs.tavily.com/"

MCP 클라이언트 구성

로컬 서비스 예시:

{
  "mcpServers": {
    "tavily-search": {
      "type": "streamable_http",
      "url": "http://127.0.0.1:21029/mcp",
      "headers": {}
    }
  }
}

원격 서비스 예시:

{
  "mcpServers": {
    "tavily-search": {
      "type": "streamable_http",
      "url": "https://your-domain.example/mcp",
      "headers": {}
    }
  }
}

서버 배포

저장소의 배포 스크립트를 사용하여 자신의 SSH 키를 통해 파일을 업로드하고 서비스를 시작할 수 있습니다:

.\scripts\deploy_remote.ps1 -HostName "your-server.example" -User "ubuntu" -IdentityFile "<path-to-private-key>"

Maintenance

ActivityStale
ResponsivenessNo recent community issues

Related MCP Connectors

Related MCP Servers