STARWARCLOUD STARWAR.AI
返回市场
MCP服务器塔维利

MCP服务器塔维利

作者：Tomatio1344 星标更新：2025-08-19
安装使用来源：spider==github.com

项目介绍

tavily-search MCP 服务器

一个 MCP 服务器项目

信任评分 <a href="https://glama.ai/mcp/servers/s0hka6zney"><img width="380" height="200" src="https://gips3.baidu.com/it/u=956426414,3855829569&fm=3081&app=3081&f=PNG?w=760&h=400" alt="tavily-search MCP 服务器" /></a>

组件

此服务器使用 Tavily API 根据指定查询执行搜索。

  • 搜索结果以文本格式返回。
  • 搜索结果包括 AI 响应、URI 和搜索结果标题。

工具

此服务器实现了以下工具：

  • search: 根据指定查询执行搜索
    • 必需参数："query"
    • 可选参数："search_depth"（基础或高级）

通过 Smithery 安装

要通过 Smithery 自动安装 Tavily Search for Claude Desktop：

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

安装

  1. 下载仓库。
git clone https://github.com/Tomatio13/mcp-server-tavily.git
  1. 打开 Claude Desktop 配置文件。
在 MacOS 上：`~/Library/Application\ Support/Claude/claude_desktop_config.json`
在 Windows 上：`C:\Users\[username]\AppData\Roaming\Claude\claude_desktop_config.json`
  1. 编辑配置文件如下：
"mcpServers": {
  "tavily-search": {
    "command": "uv",
    "args": [
      "--directory",
      "C:\\your_path\\mcp-server-tavily",
      "run",
      "tavily-search"
    ],
    "env": {
      "TAVILY_API_KEY": "YOUR_TAVILY_API_KEY",
      "PYTHONIOENCODING": "utf-8"
    }
  }
}
  1. 重启 Claude Desktop。

使用方法

在 Claude Desktop 中，当你询问“请搜索某事”时，你会收到搜索结果。

搜索示例：

请详细搜索今天镰仓的活动

响应示例：

根据搜索结果，以下活动从今天12月1日开始：
"镰仓推广摄影比赛2025"
期间：2024年12月1日至2025年1月31日
面向热爱镰仓的人们的摄影比赛
申请从今天开始接受
另外，作为相关的即将举行的活动：
12月7日，将在西武新闻社镰仓大船站东出口休息室举行12位镰仓艺术家的展览。

日志存储位置

日志存储在以下位置：

对于 Windows：

C:\Users\[username]\AppData\Roaming\Claude\logs\mcp-server-tavily-search

使用光标执行

  1. 创建一个 shell 脚本（例如，script.sh）如下所示：
#!/bin/bash
TARGET_DIR=/path/to/mcp-server-tavily
cd "${TARGET_DIR}"
export TAVILY_API_KEY="your-api-key"
export PYTHONIOENCODING=utf-8
uv --directory $PWD run tavily-search
  1. 配置光标的 MCP 服务器设置如下：
名称: tavily-search
类型: 命令
命令: /path/to/your/script.sh

  1. 保存设置。

  2. 设置保存后，你可以请求光标的 Composer-Agent “搜索某事”，它将返回搜索结果。

使用 Docker Compose 在本地环境中运行

目的

对于无法使用 Claude Desktop 的操作系统（除了 Windows/MacOS），本节解释如何使用 Docker Compose 在本地环境中设置并运行 MCP 服务器和客户端。

步骤

  1. 安装 Docker。
  2. 下载仓库。
git clone https://github.com/Tomatio13/mcp-server-tavily.git
  1. 运行 Docker Compose。
docker compose up -d
  1. 执行客户端。
docker exec mcp_server uv --directory /usr/src/app/mcp-server-tavily/src run client.py
  1. 执行结果
  2. 在搜索可用工具后，将向 Tavily 发出查询并返回响应：
2024-12-01 11:21:56,930 - tavily-search-server - INFO - 启动 Tavily 搜索服务器
2024-12-01 11:21:56,932 - tavily-search-server - INFO - 服务器初始化，启动主循环
2024-12-01 11:21:56,936 - mcp.server - INFO - 处理类型为 ListToolsRequest 的请求
2024-12-01 11:21:56,936 - tavily-search-server - INFO - 列出可用工具
可用工具: nextCursor=None tools=[Tool(name='search', description='使用 Tavily API 搜索网络', inputSchema={'type': 'object', 'properties': {'query': {'type': 'string', 'description': '搜索查询'}, 'search_depth': {'type': 'string', 'description': '搜索深度（基础或高级）', 'enum': ['basic', 'advanced']}}, 'required': ['query']})]
2024-12-01 11:21:56,937 - mcp.server - INFO - 处理类型为 CallToolRequest 的请求
2024-12-01 11:21:56,937 - tavily-search-server - INFO - TOOL_CALL_DEBUG: 调用工具 - 名称: search, 参数: {'query': '今日的东京塔的活动请告诉我'}
2024-12-01 11:21:56,937 - tavily-search-server - INFO - 使用查询执行搜索: '今日的东京塔的活动请告诉我'
2024-12-01 11:22:00,243 - httpx - INFO - HTTP 请求: POST https://api.tavily.com/search "HTTP/1.1 200 OK"
2024-12-01 11:22:00,243 - tavily-search-server - INFO - 搜索成功 - 生成答案
2024-12-01 11:22:00,243 - tavily-search-server - INFO - 搜索成功 - 结果可用
工具执行结果: content=[TextContent(type='text', text='AI 回答：\n今天的东京塔活动如下：\n1. Candlelight: Ed Sheeran 和 Coldplay 的热门歌曲串烧 - 12月01日\n2. TeamLab Planets Tokyo - 12月01日至1月21日\n\n可能还有其他活动，请查看官方网站等获取最新信息。\n\n\n\n搜索结果：\n\n1. 东京塔 (东京): 当前活动与门票 | Fever\nURL: https://feverup.com/ja/tokyo/venue/tokyo-tower\n摘要: 未找到摘要\n\n\n2. 东京塔(东京都)的设施举办活动一览 | Walker Plus\nURL: https://www.walkerplus.com/spot/ar0313s03867/e_list.html\n摘要: 未找到摘要\n\n\n3. 东京塔 - Tokyo Tower\nURL: https://www.tokyotower.co.jp/event/\n摘要: 未找到摘要\n')] isError=False