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.

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

3. 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:

• API de Tavily: consulte la documentación de Tavily

• Integración de MCP: consulte la documentación de MCP