MIT License
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
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
API de búsqueda de IA de Tavily
Related MCP Servers
- -security-license-qualityEnables AI assistants to perform up-to-date web searches through the Tavily API, providing comprehensive search results with AI-generated summaries.Last updated -6MIT License
- MIT License