Happy slice of mcp pizzaMCP.pizza

Tomatio13_mcp-server-tavily

MCP.Pizza Chef: MCP-Mirror

Tomatio13_mcp-server-tavily is an MCP server that integrates the Tavily API to perform intelligent searches based on user-specified queries. It returns search results in a structured text format, including AI-generated responses, URIs, and titles, facilitating efficient and context-rich information retrieval. The server supports a search tool with customizable depth options (basic or advanced), making it adaptable for various search needs. Installation involves cloning the repository and configuring it within the Claude Desktop environment, enabling seamless integration with LLMs for enhanced search capabilities.

Use This MCP server To

Perform AI-enhanced web searches with query inputs Retrieve structured search results including titles and URIs Integrate advanced search depth options for detailed queries Enhance LLM workflows with real-time search data Provide contextual search responses for AI agents

README

tavily-search MCP server

A MCP server project

tavily-search MCP server

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)

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

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

Tomatio13_mcp-server-tavily FAQ

How do I install Tomatio13_mcp-server-tavily?
Clone the repository from GitHub and configure it in the Claude Desktop config file on your OS.
What arguments does the search tool require?
The search tool requires a 'query' argument and optionally accepts 'search_depth' for basic or advanced searches.
What kind of results does this MCP server return?
It returns search results in text format including AI responses, URIs, and titles of the results.
Can I customize the search depth?
Yes, you can specify 'basic' or 'advanced' search depth to control the detail level of search results.
Is this server compatible with other LLMs besides Claude?
While designed for Claude Desktop, it can be adapted for use with other LLMs like OpenAI's GPT-4 and Anthropic's Claude.
Where can I find the source code?
The source code is available on GitHub at https://github.com/Tomatio13/mcp-server-tavily.
Does this server support real-time search queries?
Yes, it performs searches in real-time based on the queries provided by the client.
How does this server enhance AI workflows?
By providing structured, context-rich search results, it enables AI models to access up-to-date information during interactions.