Tavily Search

Realiza búsquedas web utilizando la API de Tavily Search.

GitHub
50
Prueba este MCPPatrocinado

Documentación

Servidor MCP de tavily-search

Un proyecto de servidor MCP

Trust Score tavily-search MCP server

Componentes

Este servidor utiliza la API de Tavily para realizar búsquedas basadas en consultas especificadas.

  • Los resultados de búsqueda se devuelven en formato de texto.
  • Los resultados de búsqueda incluyen respuestas de IA, URIs y títulos de los resultados de búsqueda.

Herramientas

Este servidor implementa las siguientes herramientas:

  • search: Realiza búsquedas basadas en consultas especificadas
    • Argumento requerido: "query"
    • Argumento opcional: "search_depth" (basic o advanced)

Instalación mediante Smithery

Para instalar Tavily Search para Claude Desktop automáticamente a través de Smithery:

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

Instalación

  1. Descargue el repositorio.
git clone https://github.com/Tomatio13/mcp-server-tavily.git
  1. Abra el archivo de configuración de Claude Desktop.
On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
On Windows: `C:\Users\[username]\AppData\Roaming\Claude\claude_desktop_config.json`
  1. Edite el archivo de configuración de la siguiente manera:
"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. Reinicie Claude Desktop.

Uso

En Claude Desktop, cuando pregunte "Por favor, busque algo", recibirá resultados de búsqueda.

Ejemplo de búsqueda:

Please search in detail for today's events in Kamakura

Ejemplo de respuesta:

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.

Ubicación de almacenamiento de registros

Los registros se almacenan en la siguiente ubicación:

Para Windows:

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

Ejecución con Cursor

  1. Cree un script de shell (por ejemplo, script.sh) como se muestra a continuación:
#!/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 los ajustes del servidor MCP de Cursor de la siguiente manera:
Name: tavily-search
Type: command
Command: /path/to/your/script.sh

  1. Guarde los ajustes.

  2. Una vez guardados los ajustes, puede pedirle al Composer-Agent de Cursor que "busque algo" y devolverá los resultados de búsqueda.

Ejecución en entorno local mediante Docker Compose

Propósito

Para sistemas operativos distintos de Windows/MacOS donde no se puede usar Claude Desktop, esta sección explica cómo configurar y ejecutar un servidor y cliente MCP en un entorno local usando Docker compose.

Pasos

  1. Instale Docker.
  2. Descargue el repositorio.
git clone https://github.com/Tomatio13/mcp-server-tavily.git
  1. Ejecute Docker compose.
docker compose up -d
  1. Ejecute el cliente.
docker exec mcp_server uv --directory /usr/src/app/mcp-server-tavily/src run client.py
  1. Resultados de la ejecución
  2. Después de buscar las herramientas disponibles como se muestra a continuación, se enviará una consulta a Tavily y se devolverá una respuesta:
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