leo-tavily-mcp

Tavily-Websuche als Leo-Provider-Paket über MCP.

Das web_search-Tool von Leo durchsucht selbst nichts – es löst einen WebSearchProvider auf und fragt diesen. Dieser Server ist einer, erreichbar als Paket, das der Hub zur Laufzeit installiert, statt eines, für das er neu gebaut werden müsste.

Was es beantwortet

Die web_search-Rolle in leo_mcp::providers:

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

Die Ergebnisse kommen als JSON in einem Text-Content-Block zurück – das ist die Konvention, die die Brücke des Hubs liest.

Related MCP server: Tavily MCP Server

Konfiguration

Eine Einstellung, die vom Paketdeskriptor deklariert und von Leo an diesen Prozess als Umgebungsvariable unter ihrem Einstellungsschlüssel, unverändert übergeben wird:

Leo übergibt nur Schlüssel, die das Paket in entitlements.settings_read deklariert hat und denen der Besitzer zugestimmt hat – niemals die gesamte Einstellungstabelle. Der Name ist kleingeschrieben, weil er der Einstellungsschlüssel ist; wenn man ihn auf einer der beiden Seiten umbenennt, kommen die Zugangsdaten stillschweigend nie an.

Ohne konfigurierten Schlüssel gibt das Tool isError mit einer Meldung zurück, die die Einstellung benennt. Das ist beabsichtigt: Eine leere Ergebnismenge würde bei Leo als „das Web hat nichts dazu“ ankommen.

Ausführen

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

Warum reines JavaScript

Dies wird als git-Tarball ausgeliefert, der an einen Commit-SHA gebunden ist, statt als npm-Paket, und npm führt Build-Schritte für eine Tarball-URL nicht zuverlässig aus. Ein TypeScript-Quellbaum würde installiert werden und dann auf dem Rechner einer anderen Person nicht starten, am anderen Ende, wo es am schwersten zu diagnostizieren ist.

Registry-Eintrag

{
  "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." }
      ]
    }
  }
}

Die URL muss einen vollständigen 40-Zeichen-Commit-SHA nennen. Ein Tag sieht genauso spezifisch aus und ist es nicht – refs/tags/v1.0.0 ist ein Zeiger, den sein Besitzer verschieben kann, nachdem der Eintrag überprüft wurde, daher lehnt der Hub ihn als nicht gepinnt ab.

Lizenz

MIT