Servidor Tavily MCP con soporte de proxy

Un servidor de Protocolo de Contexto de Modelo que ofrece funciones de búsqueda web basadas en IA mediante la API de búsqueda de Tavily, con compatibilidad adicional con configuraciones de proxy HTTP/HTTPS. Este servidor permite a los LLM realizar búsquedas web sofisticadas a través de servidores proxy, obtener respuestas directas a preguntas y buscar artículos de noticias recientes con contenido relevante extraído por IA.

Características

• Todas las características originales del servidor Tavily MCP

• Compatibilidad con proxy HTTP/HTTPS mediante variables de entorno

• Registro mejorado para configuraciones de proxy

• Manejo robusto de errores para problemas relacionados con el proxy

Related MCP server: Tavily MCP Server

Herramientas disponibles

• tavily_web_search : realiza búsquedas web integrales con extracción de contenido impulsada por IA.

  • query (cadena, obligatoria): Consulta de búsqueda

  • max_results (entero, opcional): número máximo de resultados a devolver (predeterminado: 5, máximo: 20)

  • search_depth (cadena, opcional): Profundidad de búsqueda "básica" o "avanzada" (valor predeterminado: "básica")

• tavily_answer_search : realiza búsquedas web y genera respuestas directas con evidencia de respaldo.

  • query (cadena, obligatoria): Consulta de búsqueda

  • max_results (entero, opcional): número máximo de resultados a devolver (predeterminado: 5, máximo: 20)

  • search_depth (cadena, opcional): Profundidad de búsqueda "básica" o "avanzada" (valor predeterminado: "avanzada")

• tavily_news_search : busca artículos de noticias recientes con fechas de publicación.

  • query (cadena, obligatoria): Consulta de búsqueda

  • max_results (entero, opcional): número máximo de resultados a devolver (predeterminado: 5, máximo: 20)

  • days (entero, opcional): Número de días para volver a la búsqueda (predeterminado: 3)

Instalación

Utilice pip

pip install mcp-tavily-proxy

o si tienes uv instalado:

uv pip install mcp-tavily-proxy

Construir desde la fuente

Clone este repositorio y compile e instale el programa:

git clone https://github.com/tulong66/mcp-tavily-proxy.git
cd mcp-tavily-proxy
uv build
uv pip install .

Configuración

Configuración de proxy y clave API

El servidor requiere una clave API de Tavily y admite la configuración de proxy a través de variables de entorno:

1. Establecer las variables de entorno requeridas:

# Tavily API Key
export TAVILY_API_KEY=your_api_key_here

# Proxy Settings (if needed)
export HTTP_PROXY=http://your-proxy:port
export HTTPS_PROXY=http://your-proxy:port

2. O proporcione la clave API como un argumento de la línea de comandos:

python -m mcp_server_tavily --api-key=your_api_key_here

Configurar para Claude.app

Añade a tu configuración de Claude:

{
  "mcpServers": {
    "tavily": {
      "command": "python",
      "args": ["-m", "mcp_server_tavily"]
    },
    "env": {
      "TAVILY_API_KEY": "your_api_key_here",
      "HTTP_PROXY": "http://your-proxy:port",
      "HTTPS_PROXY": "http://your-proxy:port"
    }
  }
}

Ejemplos

Para una búsqueda regular:

Tell me about Anthropic's newly released MCP protocol

Para generar un informe con exclusiones explícitas:

Tell me about redwood trees. Please use MLA format in markdown syntax and include the URLs in the citations. Exclude Wikipedia sources.

Para búsqueda de noticias:

Give me the top 10 AI-related news in the last 5 days

Depuración

Habilite el registro de depuración para ver información detallada de configuración del proxy:

export TAVILY_LOG_LEVEL=DEBUG
python -m mcp_server_tavily

También puedes utilizar el inspector MCP:

npx @modelcontextprotocol/inspector python -m mcp_server_tavily

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar solicitudes de extracción para ayudar a mejorar la compatibilidad con el proxy o añadir nuevas funciones.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

Este proyecto se basa en el mcp-tavily original con funcionalidad de soporte de proxy agregada.