leo-tavily-mcp

Búsqueda web de Tavily como paquete de proveedor de Leo, a través de MCP.

La herramienta web_search de Leo no busca nada por sí misma — resuelve un WebSearchProvider y le pide a ese. Este servidor es uno, accesible como un paquete que el hub instala en tiempo de ejecución en lugar de uno para el que tenga que ser reconstruido.

Qué responde

El rol web_search en leo_mcp::providers:

search({ query, max_results }) -> { results: [{ title, url, snippet, score? }] }

Los resultados vuelven como JSON en un bloque de contenido de texto, que es la convención que el puente del hub lee.

Related MCP server: Tavily MCP Server

Configuración

Un ajuste, declarado por el descriptor del paquete y entregado a este proceso por Leo como una variable de entorno bajo su clave de ajustes, textualmente:

Leo solo entrega las claves que el paquete declaró en entitlements.settings_read y a las que el propietario dio su consentimiento — nunca la tabla de ajustes completa. El nombre está en minúsculas porque es la clave de ajustes; renombrarlo en cualquiera de los lados significa que la credencial nunca llega silenciosamente.

Sin clave configurada, la herramienta devuelve isError con un mensaje que nombra el ajuste. Eso es deliberado: un conjunto de resultados vacío llegaría a Leo como "la web no tiene nada sobre eso".

Ejecutarlo

npm install
node index.js          # speaks MCP over stdio
npm test               # checks the response mapping, no network needed

Por qué JavaScript simple

Esto se distribuye como un tarball de git fijado a un SHA de commit en lugar de un paquete npm, y npm no ejecuta de manera fiable los pasos de compilación para una URL de tarball. Un árbol de fuentes de TypeScript se instalaría y luego fallaría al arrancar en la máquina de otra persona, en el extremo más lejano, donde es más difícil de diagnosticar.

Entrada del registro

{
  "name": "tavily",
  "label": "Web Search",
  "mcp": {
    "transport": "stdio",
    "command": "npx",
    "args": ["-y", "https://github.com/TheBananaStand/leo-tavily-mcp/archive/<40-char-sha>.tar.gz"]
  },
  "descriptor": {
    "provides": ["web_search"],
    "fields": [
      { "key": "tavily_api_key", "label": "API Key", "field_type": "password", "required": true }
    ],
    "entitlements": {
      "settings_read": ["tavily_api_key"],
      "network": ["api.tavily.com"],
      "sends": [
        { "to": "api.tavily.com", "classes": ["search_queries"],
          "because": "The search text and nothing else." }
      ]
    }
  }
}

La URL debe nombrar un SHA de commit completo de 40 caracteres. Una etiqueta parece igual de específica y no lo es — refs/tags/v1.0.0 es un puntero que su propietario puede mover después de que la entrada haya sido revisada, por lo que el hub la rechaza como no fijada.

Licencia

MIT