Servidor MCP de búsqueda de tavily

Un proyecto de servidor MCP

Componentes

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

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

Herramientas

Este servidor implementa las siguientes herramientas:

búsqueda: realiza búsquedas basadas en consultas específicas
- Argumento obligatorio: "consulta"
- Argumento opcional: "search_depth" (básico o avanzado)

Instalación mediante herrería

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

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

Instalar

Descargar el repositorio.

git clone https://github.com/Tomatio13/mcp-server-tavily.git

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`

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

Reinicie Claude Desktop.

Uso

En Claude Desktop, cuando pides "Busca algo", recibirás resultados de la 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

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

Configure los ajustes del servidor MCP de Cursor de la siguiente manera:

Name: tavily-search
Type: command
Command: /path/to/your/script.sh

Guardar la configuración.
Una vez guardadas las configuraciones, puedes pedirle a Cursor's Composer-Agent que "busque algo" y te devolverá los resultados de la búsqueda.

Ejecución en entorno local con Docker Compose

Objetivo

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 un cliente MCP en un entorno local utilizando Docker Compose.

Pasos

Instalar Docker.
Descargar el repositorio.

git clone https://github.com/Tomatio13/mcp-server-tavily.git

Ejecutar Docker Compose.

docker compose up -d

Ejecutar el cliente.

docker exec mcp_server uv --directory /usr/src/app/mcp-server-tavily/src run client.py

Resultados de la ejecución
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