leo-tavily-mcp

Tavily 웹 검색을 MCP 위에서 Leo 공급자 패키지로 제공합니다.

Leo의 web_search 도구는 자체적으로 아무것도 검색하지 않습니다. WebSearchProvider를 확인하여 그쪽에 요청할 뿐입니다. 이 서버는 허브가 다시 빌드할 필요 없이 런타임에 설치하는 패키지로 제공되는 하나의 구현체입니다.

제공 기능

leo_mcp::providers의 web_search 역할:

search({ query, max_results }) -> { results: [{ title, url, snippet, score? }] }

결과는 텍스트 콘텐츠 블록의 JSON으로 반환되며, 이는 허브의 브리지가 읽는 규칙입니다.

Related MCP server: Tavily MCP Server

구성

패키지 설명자에 선언되고 Leo가 설정 키 아래에 그대로 환경 변수로 이 프로세스에 전달하는 설정이 하나 있습니다:

Leo는 패키지가 entitlements.settings_read에 선언하고 소유자가 동의한 키만 전달하며, 전체 설정 테이블을 절대 넘겨주지 않습니다. 이름이 소문자인 이유는 그것이 설정 키이기 때문입니다. 어느 한쪽에서 이름을 바꾸면 자격 증명이 조용히 도착하지 않습니다.

키가 구성되지 않으면 도구는 설정 이름을 언급하는 메시지와 함께 isError를 반환합니다. 이는 의도적인 것입니다. 빈 결과 집합은 "웹에 그에 대한 내용이 없다"는 뜻으로 Leo에 전달되기 때문입니다.

실행

npm install
node index.js          # speaks MCP over stdio
npm test               # checks the response mapping, no network needed

순수 JavaScript를 사용하는 이유

이 패키지는 npm 패키지가 아닌 커밋 SHA에 고정된 git tarball로 제공되며, npm은 tarball URL에 대한 빌드 단계를 안정적으로 실행하지 않습니다. TypeScript 소스 트리는 설치된 후 다른 사람의 머신, 즉 진단하기 가장 어려운 막다른 지점에서 시작에 실패할 것입니다.

레지스트리 항목

{
  "name": "tavily",
  "label": "Web Search",
  "mcp": {
    "transport": "stdio",
    "command": "npx",
    "args": ["-y", "https://github.com/TheBananaStand/leo-tavily-mcp/archive/<40-char-sha>.tar.gz"]
  },
  "descriptor": {
    "provides": ["web_search"],
    "fields": [
      { "key": "tavily_api_key", "label": "API Key", "field_type": "password", "required": true }
    ],
    "entitlements": {
      "settings_read": ["tavily_api_key"],
      "network": ["api.tavily.com"],
      "sends": [
        { "to": "api.tavily.com", "classes": ["search_queries"],
          "because": "The search text and nothing else." }
      ]
    }
  }
}

URL은 전체 40자 커밋 SHA를 지정해야 합니다. 태그도 똑같이 구체적으로 보이지만 그렇지 않습니다. refs/tags/v1.0.0은 항목이 검토된 후 소유자가 이동할 수 있는 포인터이므로 허브는 고정되지 않은 것으로 간주하여 거부합니다.

라이선스

MIT