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

Clonar el repositorio
Instalar dependencias:

npm install

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.

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/AmazingFeature )
Confirme sus cambios ( git commit -m 'Add some AmazingFeature' )
Empujar a la rama ( git push origin feature/AmazingFeature )
Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT.

Apoyo

Para cualquier duda o problema:

API de Tavily: consulte la documentación de Tavily
Integración de MCP: consulte la documentación de MCP

MCP Tavily

Integrations

MCP Tavily

Características

Uso con MCP

Referencia de API

Herramientas de búsqueda

1. Búsqueda básica

2. Búsqueda de contexto

3. Búsqueda de preguntas y respuestas

Herramienta de extracción

Opciones de búsqueda

Opciones de extracción

Formato de respuesta

Manejo de errores

Instalación

Instalación mediante herrería

Instalación manual

Prerrequisitos

Configuración

Edificio

Depuración con MCP Inspector

Contribuyendo

Licencia

Apoyo

Tools

Related Resources

Appeared in Searches