Skip to main content
Glama
Sign In
enesjakozh

tavily-search

by Tomatio13
GitHub
Python
MIT License
26
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

tavily-search MCP server

A MCP server project

Components

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

  • Search results are returned in text format.
  • Search results include AI responses, URIs, and titles of the search results.

Tools

This server implements the following tools:

  • search: Performs searches based on specified queries
    • Required argument: "query"
    • Optional argument: "search_depth" (basic or advanced)

Installing via Smithery

To install Tavily Search for Claude Desktop automatically via Smithery :

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

Install

  1. Download the repository.
git clone https://github.com/Tomatio13/mcp-server-tavily.git
  1. Open the Claude Desktop configuration file.
On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json` On Windows: `C:\Users\[username]\AppData\Roaming\Claude\claude_desktop_config.json`
  1. Edit the configuration file as follows:
"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. Restart Claude Desktop.

Usage

In Claude Desktop, when you ask "Please search for something", you will receive search results.

Search example:

Please search in detail for today's events in Kamakura

Response example:

According to the search results, the following events start today, December 1st: "Kamakura Promotion Photo Contest 2025" Period: December 1, 2024 - January 31, 2025 A photo contest for those who love Kamakura Applications start accepting from today Also, as a related upcoming event: On December 7th, an exhibition by 12 Kamakura artists will be held at the Seibu Press Inn Kamakura Ofuna Station East Exit Lounge.

Log Storage Location

Logs are stored in the following location:

For Windows:

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

Execution with Cursor

  1. Create a shell script (eg, script.sh ) as shown below:
#!/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. Configure Cursor's MCP Server settings as follows:
Name: tavily-search Type: command Command: /path/to/your/script.sh
  1. Save the settings.
  2. Once the settings are saved, you can ask Cursor's Composer-Agent to "search for something," and it will return the search results.

Running in Local Environment Using Docker Compose

Purpose

For operating systems other than Windows/MacOS where Claude Desktop cannot be used, this section explains how to set up and run an MCP server and client in a local environment using Docker compose.

Steps

  1. Install Docker.
  2. Download the repository.
git clone https://github.com/Tomatio13/mcp-server-tavily.git
  1. Run Docker compose.
docker compose up -d
  1. Execute the client.
docker exec mcp_server uv --directory /usr/src/app/mcp-server-tavily/src run client.py
  1. Execution Results
  2. After searching for available tools as shown below, a query will be issued to Tavily and a response will be returned:
2024-12-01 11:21:56,930 - tavily-search-server - INFO - Starting Tavily search server 2024-12-01 11:21:56,932 - tavily-search-server - INFO - Server initialized, starting main loop 2024-12-01 11:21:56,936 - mcp.server - INFO - Processing request of type ListToolsRequest 2024-12-01 11:21:56,936 - tavily-search-server - INFO - Listing available tools 利用可能なツール: nextCursor=None tools=[Tool(name='search', description='Search the web using Tavily API', inputSchema={'type': 'object', 'properties': {'query': {'type': 'string', 'description': 'Search query'}, 'search_depth': {'type': 'string', 'description': 'Search depth (basic or advanced)', 'enum': ['basic', 'advanced']}}, 'required': ['query']})] 2024-12-01 11:21:56,937 - mcp.server - INFO - Processing request of type CallToolRequest 2024-12-01 11:21:56,937 - tavily-search-server - INFO - TOOL_CALL_DEBUG: Tool called - name: search, arguments: {'query': '今日の東京タワーのイベントを教えて下さい'} 2024-12-01 11:21:56,937 - tavily-search-server - INFO - Executing search with query: '今日の東京タワーのイベントを教えて下さい' 2024-12-01 11:22:00,243 - httpx - INFO - HTTP Request: POST https://api.tavily.com/search "HTTP/1.1 200 OK" 2024-12-01 11:22:00,243 - tavily-search-server - INFO - Search successful - Answer generated 2024-12-01 11:22:00,243 - tavily-search-server - INFO - Search successful - Results available ツール実行結果: content=[TextContent(type='text', text='AI Answer:\n今日の東京タワーのイベントは以下の通りです：\n1. Candlelight: エド・シーランとコールドプレイのヒットメドレー - 12月01日\n2. チームラボプラネッツ TOKYO - 12月01日から1月21日\n\n他にもイベントがある可能性がありますので、公式ウェブサイト等で最新情報をご確認ください。\n\n\n\nSearch Results:\n\n1. 東京タワー (東京): 現在のイベントとチケット | Fever\nURL: https://feverup.com/ja/tokyo/venue/tokyo-tower\nSummary: Summary not found\n\n\n2. 東京タワー(東京都)の施設で開催するイベント一覧｜ウォーカープラス\nURL: https://www.walkerplus.com/spot/ar0313s03867/e_list.html\nSummary: Summary not found\n\n\n3. 東京タワー - Tokyo Tower\nURL: https://www.tokyotower.co.jp/event/\nSummary: Summary not found\n')] isError=False

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Tavily AI search API

  1. Components
    1. Tools
    2. Installing via Smithery
    3. Install
  2. Usage
    1. Log Storage Location
      1. Execution with Cursor
        1. Running in Local Environment Using Docker Compose
          1. Purpose
          2. Steps

        Related MCP Servers

        • Brave Search MCP Server

          arben-adm
          A
          security
          A
          license
          A
          quality
          Facilitates integration of Brave Search functionalities with AI assistants through the Model Context Protocol, enabling web and local searches using the Brave Search API.
          Last updated -
          2
          4
          Python
          MIT License

        • Tavily MCP Serverofficial

          tavily-ai
          A
          security
          A
          license
          A
          quality
          This server enables AI systems to integrate with Tavily's search and data extraction tools, providing real-time web information access and domain-specific searches.
          Last updated -
          2
          6,005
          403
          JavaScript
          MIT License
          • Apple
          • Linux

        • MCP2Tavily

          mcp2everything
          A
          security
          F
          license
          A
          quality
          An MCP protocol server that enables web search functionality using the Tavily API, allowing AI assistants to perform internet searches in real-time.
          Last updated -
          4
          2
          Python

        • Tavily MCP Server

          RamXX
          -
          security
          A
          license
          -
          quality
          Provides AI-powered web search capabilities using Tavily's search API, enabling LLMs to perform sophisticated web searches, get direct answers to questions, and search recent news articles.
          Last updated -
          53
          Python
          MIT License
          • Linux
          • Apple

        View all related MCP servers

        Appeared in Searches

        New MCP Servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/Tomatio13/mcp-server-tavily'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server