MCP Server Tavily

🚀 Tavily Search MCP Server

An MCP project that utilizes the Tavily API.

🚀 Quick Start

This server uses the Tavily API to perform searches based on specified queries.

✨ Features

Components

• The server uses the Tavily API to execute searches based on specified queries.
• Search results are returned in text format.
• Search results include AI answers, URIs, and titles of the search results.

Tools

The server implements the following tools:

• search: Perform a search based on a specified query
  • Required parameter: "query"
  • Optional parameter: "search_depth" (basic or advanced)

📦 Installation

Installation via Smithery

To automatically install Tavily Search for Claude Desktop via Smithery:

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

Manual Installation

1. Clone the repository.

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

2. Follow the steps in the README for installation and configuration.

💻 Usage Examples

Basic Usage

After installation, start the server:

from tavily_search_server import TavilySearchServer

# Initialize the server
server = TavilySearchServer()

# Start the server
if __name__ == "__main__":
    server.start()

Advanced Usage

Request to Get Available Tools

{
  "type": "ListToolsRequest"
}

Response for Available Tools

{
  "tools": [
    {
      "name": "search",
      "description": "Search the web using the Tavily API",
      "input_schema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Search query"
          },
          "search_depth": {
            "type": "string",
            "description": "Search depth (basic or advanced)",
            "enum": ["basic", "advanced"]
          }
        },
        "required": ["query"]
      }
    }
  ]
}

Request to Call a Tool

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

Response for Calling a Tool

{
  "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
}