tavily-search MCP server

tavily-search MCP server

tavily-search MCP server 是一个使用 Tavily API 通过 Claude Desktop 获取网页结果(文本、链接)的本地搜索服务,支持多语言查询和自定义搜索深度。

Tavily-Search MCP 服务器快速上手指南

tavily-search MCP Server

简介

Tavily-Search MCP 服务器使用 Tavily API 为 Claude 提供网络搜索能力,支持多语言查询和自定义搜索深度。

功能

  • 根据查询执行网络搜索
  • 返回 AI 摘要回答、链接和搜索结果标题
  • 支持基本(basic)和高级(advanced)搜索深度

安装方法

方法 1: 通过 Smithery 安装 (推荐)

npx -y @smithery/cli install tavily-search --client claude

方法 2: 手动安装 (Claude Desktop)

  1. 克隆仓库

    git clone https://github.com/Tomatio13/mcp-server-tavily.git
    
  2. 配置 Claude Desktop

    • 打开配置文件:
      • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
      • Windows: C:Users[username]AppDataRoamingClaudeclaude_desktop_config.json
    • 添加以下配置:
    "mcpServers": {
      "tavily-search": {
        "command": "uv",
        "args": [
          "--directory",
          "路径/到/mcp-server-tavily",
          "run",
          "tavily-search"
        ],
        "env": {
          "TAVILY_API_KEY": "你的_TAVILY_API_KEY",
          "PYTHONIOENCODING": "utf-8"
        }
      }
    }
    
  3. 重启 Claude Desktop

方法 3: Docker 方式 (跨平台)

git clone https://github.com/Tomatio13/mcp-server-tavily.git
cd mcp-server-tavily
docker compose up -d
docker exec mcp_server uv --directory /usr/src/app/mcp-server-tavily/src run client.py

使用方法

在 Claude 中直接请求搜索信息:

请搜索今天镰仓的活动

搜索深度可以指定为基本或高级:

请使用高级搜索深度查找关于量子计算最新进展的信息

日志位置

  • Windows: C:Users[username]AppDataRoamingClaudelogsmcp-server-tavily-search

故障排除

  • 确保 Tavily API 密钥有效
  • 检查日志文件获取错误信息
  • 重启 Claude Desktop 或 Docker 容器

需要完整文档和更多示例,请访问 GitHub 仓库