Skip to main content
Glama
Sign In
enesjakozh

MCP Tavily

by kshern
npmGitHub
JavaScript
MIT License
57
1
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP Tavily

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.

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:

You must be authenticated.

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

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Un servidor de protocolo de contexto de modelo que permite la búsqueda avanzada y la extracción de contenido mediante la API de Tavily, con amplias opciones de personalización e integración.

  1. Características
    1. Uso con MCP
  2. Referencia de API
    1. Herramientas de búsqueda
    2. Herramienta de extracción
    3. Opciones de búsqueda
    4. Opciones de extracción
  3. Formato de respuesta
    1. Manejo de errores
      1. Instalación
        1. Instalación mediante herrería
        2. Instalación manual
        3. Prerrequisitos
        4. Configuración
        5. Edificio
      2. Depuración con MCP Inspector
        1. Contribuyendo
          1. Licencia
            1. Apoyo

              Related Resources

              Related MCP Servers

              • Search1API MCP Server

                fatwang2
                A
                security
                A
                license
                A
                quality
                A Model Context Protocol (MCP) server that provides search and crawl functionality using Search1API.
                Last updated -
                5
                206
                111
                TypeScript
                MIT License
                • Apple

              • MCP Server Fetch TypeScript

                tatn
                A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that provides web content fetching and conversion capabilities.
                Last updated -
                4
                89
                2
                JavaScript
                MIT License
                • Apple

              • mcp-local-rag

                nkapila6
                -
                security
                A
                license
                -
                quality
                "primitive" RAG-like web search model context protocol server that runs locally. ✨ no APIs ✨
                Last updated -
                43
                Python
                MIT License
                • Linux
                • Apple

              • OneSearch MCP Server

                yokingma
                -
                security
                A
                license
                -
                quality
                A Model Context Protocol server that enables web search, scraping, crawling, and content extraction through multiple engines including SearXNG, Firecrawl, and Tavily.
                Last updated -
                35
                11
                TypeScript
                MIT License

              View all related MCP servers

              Appeared in Searches

              New MCP Servers

              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