MCP 타빌리

중국어판

Tavily API를 위한 MCP(Model Context Protocol) 서버 구현으로 고급 검색 및 콘텐츠 추출 기능을 제공합니다.

특징

다양한 검색 도구 :
- search : 사용자 정의 가능한 옵션이 있는 기본 검색 기능
- searchContext : 더 나은 관련성을 위한 컨텍스트 인식 검색
- searchQNA : 질문과 답변 중심 검색
콘텐츠 추출 : 구성 가능한 옵션을 사용하여 URL에서 콘텐츠 추출
풍부한 구성 옵션 : 검색 심도, 필터링 및 콘텐츠 포함을 위한 광범위한 옵션

MCP와 함께 사용

MCP 구성에 Tavily MCP 서버를 추가합니다.

지엑스피1

참고: your-api-key 실제 Tavily API 키로 바꿔야 합니다. 서버를 실행하기 전에 환경 변수 TAVILY_API_KEY 로 설정할 수도 있습니다.

API 참조

검색 도구

서버는 MCP를 통해 호출할 수 있는 세 가지 검색 도구를 제공합니다.

1. 기본 검색

// Tool name: search
{
  query: "artificial intelligence",
  options: {
    searchDepth: "advanced",
    topic: "news",
    maxResults: 10
  }
}

2. 컨텍스트 검색

// Tool name: searchContext
{
  query: "latest developments in AI",
  options: {
    topic: "news",
    timeRange: "week"
  }
}

3. Q&A 검색

// Tool name: searchQNA
{
  query: "What is quantum computing?",
  options: {
    includeAnswer: true,
    maxResults: 5
  }
}

추출 도구

// Tool name: extract
{
  urls: ["https://example.com/article1", "https://example.com/article2"],
  options: {
    extractDepth: "advanced",
    includeImages: true
  }
}

검색 옵션

모든 검색 도구는 다음 옵션을 공유합니다.

interface SearchOptions {
  searchDepth?: "basic" | "advanced";    // Search depth level
  topic?: "general" | "news" | "finance"; // Search topic category
  days?: number;                         // Number of days to search
  maxResults?: number;                   // Maximum number of results
  includeImages?: boolean;               // Include images in results
  includeImageDescriptions?: boolean;    // Include image descriptions
  includeAnswer?: boolean;               // Include answer in results
  includeRawContent?: boolean;           // Include raw content
  includeDomains?: string[];            // List of domains to include
  excludeDomains?: string[];            // List of domains to exclude
  maxTokens?: number;                    // Maximum number of tokens
  timeRange?: "year" | "month" | "week" | "day" | "y" | "m" | "w" | "d"; // Time range for search
}

추출 옵션

interface ExtractOptions {
  extractDepth?: "basic" | "advanced";   // Extraction depth level
  includeImages?: boolean;               // Include images in results
}

응답 형식

모든 도구는 다음 형식으로 응답을 반환합니다.

{
  content: Array<{
    type: "text",
    text: string
  }>
}

검색 결과에는 각 항목에 다음이 포함됩니다.

제목
콘텐츠
URL

추출된 콘텐츠의 각 항목에는 다음이 포함됩니다.

URL
원시 콘텐츠
실패한 URL 목록(있는 경우)

오류 처리

모든 도구에는 적절한 오류 처리 기능이 포함되어 있으며, 문제가 발생하면 설명적인 오류 메시지를 표시합니다.

설치

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 Tavily API Server를 자동으로 설치하려면:

npx -y @smithery/cli install @kshern/mcp-tavily --client claude

수동 설치

npm install @mcptools/mcp-tavily

또는 npx와 함께 직접 사용하세요:

npx @mcptools/mcp-tavily

필수 조건

Node.js 16 이상
npm 또는 yarn
Tavily API 키( Tavily 에서 하나 받으세요)

설정

저장소를 복제합니다
종속성 설치:

npm install

Tavily API 키를 설정하세요:

export TAVILY_API_KEY=your_api_key

건물

npm run build

MCP Inspector를 사용한 디버깅

개발 및 디버깅을 위해 MCP 서버를 위한 강력한 개발 도구인 MCP Inspector를 사용하는 것이 좋습니다.

Inspector는 다음을 위한 사용자 인터페이스를 제공합니다.

테스트 도구 호출
서버 응답 보기
디버깅 도구 실행
서버 상태 모니터링

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/AmazingFeature )
변경 사항을 커밋합니다( git commit -m 'Add some AmazingFeature' )
브랜치에 푸시( git push origin feature/AmazingFeature )
풀 리퀘스트 열기

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

지원하다

질문이나 문제가 있으시면:

Tavily API: Tavily 문서를 참조하세요.
MCP 통합: MCP 설명서를 참조하세요.

MCP Tavily

Integrations