mcp-server-tavily

🚀 Tavily 搜索 MCP 服务器

这是一个使用 Tavily API 的 MCP 项目，借助 Tavily API 可执行基于指定查询的搜索，为用户提供包含 AI 回答、URI 和标题的搜索结果。

🚀 快速开始

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Tavily 搜索以用于 Claude Desktop，可执行以下命令：

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

手动安装

1. 克隆仓库：

git clone https://github.com/your-repository.git

2. 按照 README 中的步骤进行安装和配置。

启动服务器

安装完成后，可通过以下示例代码启动服务器：

from tavily_search_server import TavilySearchServer

# 初始化服务器
server = TavilySearchServer()

# 启动服务器
if __name__ == "__main__":
    server.start()

✨ 主要特性

组件功能

此服务器使用 Tavily API 执行基于指定查询的搜索，具有以下特点：

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

工具实现

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

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

💻 使用示例

基础用法

获取可用工具

向服务器发送请求以获取可用工具：

{
  "type": "ListToolsRequest"
}

响应示例：

{
  "tools": [
    {
      "name": "search",
      "description": "使用 Tavily API 搜索网络",
      "input_schema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "搜索查询"
          },
          "search_depth": {
            "type": "string",
            "description": "搜索深度（基本或高级）",
            "enum": ["basic", "advanced"]
          }
        },
        "required": ["query"]
      }
    }
  ]
}

调用工具

向服务器发送请求以调用工具：

{
  "type": "CallToolRequest",
  "tool_name": "search",
  "arguments": {
    "query": "今日的東京塔的活動請告知"
  }
}

响应示例：

{
  "content": [
    {
      "type": "text",
      "text": "AI 回答:\n今天東京塔的活動如下：\n1. 熠光之夜 - 爱德·希尔렝和酷玩乐团的热门曲目串烧 - 12月01日\n2. TeamLab Planet 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\n2. 東京塔(東京都)舉辦的活動一覽｜Walker Plus\nURL: https://www.walkerplus.com/spot/ar0313s03867/e_list.html\n摘要：摘要未找到\n\n3. 東京塔 - Tokyo Tower\nURL: https://www.tokyotower.co.jp/event/\n摘要：摘要未找到"
    }
  ],
  "is_error": false
}