leo-tavily-mcp

Tavilyウェブ検索を、MCPを介したLeoプロバイダーパッケージとして提供します。

Leoのweb_searchツールはそれ自体では何も検索しません。WebSearchProviderを解決して、それに問い合わせます。このサーバーはその1つであり、ハブが実行時にインストールするパッケージとして到達可能です。ハブを再ビルドする必要はありません。

回答する内容

leo_mcp::providersにおけるweb_searchロール:

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

結果はテキストコンテンツブロック内のJSONとして返されます。これはハブのブリッジが読み取る慣例です。

Related MCP server: Tavily MCP Server

設定

パッケージ記述子によって宣言され、Leoからこのプロセスに環境変数としてその設定キー名のまま、逐語的に渡される設定が1つあります:

Leoは、パッケージがentitlements.settings_readで宣言し、所有者が同意したキーのみを渡します。設定テーブル全体を渡すことは決してありません。名前が小文字なのは、それがそのまま設定キーだからです。どちらかの側で名前を変更すると、資格情報は黙って届かなくなります。

キーが設定されていない場合、ツールは設定名を明示するメッセージとともにisErrorを返します。これは意図的です。空の結果セットは「ウェブにはそれに関する情報がない」としてLeoに届くことになるからです。

実行方法

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

プレーンなJavaScriptである理由

これはnpmパッケージではなく、コミットSHAに固定されたgit tarballとして配布されます。npmはtarball URLに対してビルドステップを確実に実行しません。TypeScriptのソースツリーはインストールされた後、他の誰かのマシンで起動に失敗することになります。しかも、診断が最も難しい遠い側でです。

レジストリエントリ

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

URLは完全な40文字のコミットSHAを指定する必要があります。タグも同様に具体的に見えますが、実際はそうではありません。refs/tags/v1.0.0は、エントリがレビューされた後に所有者が移動できるポインタです。そのため、ハブは固定されていないとして拒否します。

ライセンス

MIT