Skip to main content
Glama
enesjakozh
kshern

MCP Tavily

by kshern
OverviewInspectSchemaRelated ServersScoreDiscussions
JavaScript
Remote

MCP Tavily

insignia de herrería

Lengua china

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) para la API de Tavily, que proporciona capacidades avanzadas de búsqueda y extracción de contenido.

Características

  • Varias herramientas de búsqueda :

    • search : Funcionalidad de búsqueda básica con opciones personalizables

    • searchContext : Búsqueda contextual para una mayor relevancia

    • searchQNA : Búsqueda centrada en preguntas y respuestas

  • Extracción de contenido : extraiga contenido de las URL con opciones configurables

  • Opciones de configuración enriquecidas : amplias opciones de profundidad de búsqueda, filtrado e inclusión de contenido

Uso con MCP

Agregue el servidor Tavily MCP a su configuración de MCP:

{ "mcpServers": { "tavily": { "command": "npx", "args": ["-y", "@mcptools/mcp-tavily"], "env": { "TAVILY_API_KEY": "your-api-key" } } } }

Nota: Asegúrate de reemplazar your-api-key con tu clave API de Tavily. También puedes configurarla como variable de entorno TAVILY_API_KEY antes de ejecutar el servidor.

Related MCP server: Deep Research MCP Server

Referencia de API

Herramientas de búsqueda

El servidor proporciona tres herramientas de búsqueda que se pueden llamar a través de MCP:

1. Búsqueda básica

// Tool name: search { query: "artificial intelligence", options: { searchDepth: "advanced", topic: "news", maxResults: 10 } }

2. Búsqueda de contexto

// Tool name: searchContext { query: "latest developments in AI", options: { topic: "news", timeRange: "week" } }

3. Búsqueda de preguntas y respuestas

// Tool name: searchQNA { query: "What is quantum computing?", options: { includeAnswer: true, maxResults: 5 } }

Herramienta de extracción

// Tool name: extract { urls: ["https://example.com/article1", "https://example.com/article2"], options: { extractDepth: "advanced", includeImages: true } }

Opciones de búsqueda

Todas las herramientas de búsqueda comparten estas opciones:

interface SearchOptions { searchDepth?: "basic" | "advanced"; // Search depth level topic?: "general" | "news" | "finance"; // Search topic category days?: number; // Number of days to search maxResults?: number; // Maximum number of results includeImages?: boolean; // Include images in results includeImageDescriptions?: boolean; // Include image descriptions includeAnswer?: boolean; // Include answer in results includeRawContent?: boolean; // Include raw content includeDomains?: string[]; // List of domains to include excludeDomains?: string[]; // List of domains to exclude maxTokens?: number; // Maximum number of tokens timeRange?: "year" | "month" | "week" | "day" | "y" | "m" | "w" | "d"; // Time range for search }

Opciones de extracción

interface ExtractOptions { extractDepth?: "basic" | "advanced"; // Extraction depth level includeImages?: boolean; // Include images in results }

Formato de respuesta

Todas las herramientas devuelven respuestas en el siguiente formato:

{ content: Array<{ type: "text", text: string }> }

Para los resultados de búsqueda, cada elemento incluye:

  • Título

  • Contenido

  • URL

Para el contenido extraído, cada elemento incluye:

  • URL

  • Contenido sin procesar

  • Lista de URL fallidas (si las hay)

Manejo de errores

Todas las herramientas incluyen un manejo de errores adecuado y arrojarán mensajes de error descriptivos si algo sale mal.

Instalación

Instalación mediante herrería

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

npx -y @smithery/cli install @kshern/mcp-tavily --client claude

Instalación manual

npm install @mcptools/mcp-tavily

O úselo directamente con npx:

npx @mcptools/mcp-tavily

Prerrequisitos

  • Node.js 16 o superior

  • npm o hilo

  • Clave API de Tavily (obtenga una de Tavily )

Configuración

  1. Clonar el repositorio

  2. Instalar dependencias:

npm install

  1. Establezca su clave API de Tavily:

export TAVILY_API_KEY=your_api_key

Edificio

npm run build

Depuración con MCP Inspector

Para el desarrollo y la depuración, recomendamos utilizar MCP Inspector , una potente herramienta de desarrollo para servidores MCP.

El Inspector proporciona una interfaz de usuario para:

  • Llamadas a herramientas de prueba

  • Visualización de las respuestas del servidor

  • Ejecución de la herramienta de depuración

  • Monitoreo del estado del servidor

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

  1. Bifurcar el repositorio

  2. Crea tu rama de funciones ( git checkout -b feature/AmazingFeature )

  3. Confirme sus cambios ( git commit -m 'Add some AmazingFeature' )

  4. Empujar a la rama ( git push origin feature/AmazingFeature )

  5. Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT.

Apoyo

Para cualquier duda o problema:

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kshern/mcp-tavily'

If you have feedback or need assistance with the MCP directory API, please join our Discord server