プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

Agg Search

作者:TsukimioRinkaバージョン 1.0.0i★ 1iパソコンで動くリポジトリ ↗
レジストリ名io.github.TsukimioRinka/agg-search

インストール方法

できること

Multi-engine web search with RRF fusion and Jina reranking, plus a tiered fetcher.

作者による原文

  • 接続方法 パソコンで動く
  • アカウントまたはキー EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY が必要
  • カテゴリ 検索・AIの記憶

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

作者:google-research★ 35,6421 個の skill

Skill · 手順書

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

作者:BigBodyCobain★ 11,6081 個の skill

Skill · 手順書

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

作者:gosom★ 8,2561 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気4/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア16/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Agg Search をインストールして。https://mcp.popnx.com/i/tsukimiorinka-agg-search.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月21日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

Agg Search のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Agg Search を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "agg-search": { "command": "uvx", "args": [ "agg-search", "agg-search-mcp" ], "env": { "EXA_API_KEY": "your-value", "BRAVE_API_KEY": "your-value", "SERPER_API_KEY": "your-value", "MCP_ANYSEARCH_API_KEY": "your-value", "FIRECRAWL_API_KEY": "your-value", "TAVILY_API_KEY": "your-value", "DEEPSEEK_API_KEY": "your-value", "JINA_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Agg Search のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. Agg Search に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  4. この設定を貼り付けて保存

    {
      "mcpServers": {
        "agg-search": {
          "command": "uvx",
          "args": [
            "agg-search",
            "agg-search-mcp"
          ],
          "env": {
            "EXA_API_KEY": "your-value",
            "BRAVE_API_KEY": "your-value",
            "SERPER_API_KEY": "your-value",
            "MCP_ANYSEARCH_API_KEY": "your-value",
            "FIRECRAWL_API_KEY": "your-value",
            "TAVILY_API_KEY": "your-value",
            "DEEPSEEK_API_KEY": "your-value",
            "JINA_API_KEY": "your-value"
          }
        }
      }
    }

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude を終了してもう一度開く

  6. 試してみる

    Agg Search を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Agg Search を使っていると言うか、回答に Agg Search のツール名が出れば接続成功です

追加の設定 3 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • SEARXNG_URL セルフホスト型 SearXNG のベース URL
    英語の原文を見るSelf-hosted SearXNG base URL
  • AGG_SEARCH_PORTAL ポータルのプリセット( . 、例: codex.academic)。
    英語の原文を見るPortal preset ( . , e.g. codex.academic)
  • AGG_SEARCH_PROFILE ドメインプロファイルの上書き(general、academic、code、news)
    英語の原文を見るDomain profile override (general, academic, code, news)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Agg Search につなげません

Agg Search はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Agg Search につなげるアプリを使う

  • Agg Search のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • Agg Search のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • Agg Search のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • Agg Search のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

B · 検索・AIの記憶 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

Agg Search のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Agg Search を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user agg-search --env EXA_API_KEY=your-value --env BRAVE_API_KEY=your-value --env SERPER_API_KEY=your-value --env MCP_ANYSEARCH_API_KEY=your-value --env FIRECRAWL_API_KEY=your-value --env TAVILY_API_KEY=your-value --env DEEPSEEK_API_KEY=your-value --env JINA_API_KEY=your-value -- uvx agg-search agg-search-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Agg Search のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. Agg Search に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  4. このコマンドを貼り付けて Enter

    claude mcp add --scope user agg-search --env EXA_API_KEY=your-value --env BRAVE_API_KEY=your-value --env SERPER_API_KEY=your-value --env MCP_ANYSEARCH_API_KEY=your-value --env FIRECRAWL_API_KEY=your-value --env TAVILY_API_KEY=your-value --env DEEPSEEK_API_KEY=your-value --env JINA_API_KEY=your-value -- uvx agg-search agg-search-mcp

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude Code で /mcp と入力

    Agg Search が一覧にあり、接続済みと表示されれば OK です

  6. 試してみる

    Agg Search を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Agg Search を使っていると言うか、回答に Agg Search のツール名が出れば接続成功です

追加の設定 3 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • SEARXNG_URL セルフホスト型 SearXNG のベース URL
    英語の原文を見るSelf-hosted SearXNG base URL
  • AGG_SEARCH_PORTAL ポータルのプリセット( . 、例: codex.academic)。
    英語の原文を見るPortal preset ( . , e.g. codex.academic)
  • AGG_SEARCH_PROFILE ドメインプロファイルの上書き(general、academic、code、news)
    英語の原文を見るDomain profile override (general, academic, code, news)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

Agg Search のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Agg Search を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "agg-search": { "command": "uvx", "args": [ "agg-search", "agg-search-mcp" ], "env": { "EXA_API_KEY": "your-value", "BRAVE_API_KEY": "your-value", "SERPER_API_KEY": "your-value", "MCP_ANYSEARCH_API_KEY": "your-value", "FIRECRAWL_API_KEY": "your-value", "TAVILY_API_KEY": "your-value", "DEEPSEEK_API_KEY": "your-value", "JINA_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Agg Search のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. Agg Search に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  4. キーを入力

    Agg Search の設定で EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Cursor の AI チャットを Agent モードで開く

  6. 試してみる

    Agg Search を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Agg Search を使っていると言うか、回答に Agg Search のツール名が出れば接続成功です

追加の設定 3 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • SEARXNG_URL セルフホスト型 SearXNG のベース URL
    英語の原文を見るSelf-hosted SearXNG base URL
  • AGG_SEARCH_PORTAL ポータルのプリセット( . 、例: codex.academic)。
    英語の原文を見るPortal preset ( . , e.g. codex.academic)
  • AGG_SEARCH_PROFILE ドメインプロファイルの上書き(general、academic、code、news)
    英語の原文を見るDomain profile override (general, academic, code, news)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

Agg Search のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Agg Search を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "agg-search": { "type": "stdio", "command": "uvx", "args": [ "agg-search", "agg-search-mcp" ], "env": { "EXA_API_KEY": "your-value", "BRAVE_API_KEY": "your-value", "SERPER_API_KEY": "your-value", "MCP_ANYSEARCH_API_KEY": "your-value", "FIRECRAWL_API_KEY": "your-value", "TAVILY_API_KEY": "your-value", "DEEPSEEK_API_KEY": "your-value", "JINA_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Agg Search のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. Agg Search に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  4. キーを入力

    Agg Search の設定で EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. VS Code の AI チャットを Agent モードで開く

  6. 試してみる

    Agg Search を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Agg Search を使っていると言うか、回答に Agg Search のツール名が出れば接続成功です

追加の設定 3 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • SEARXNG_URL セルフホスト型 SearXNG のベース URL
    英語の原文を見るSelf-hosted SearXNG base URL
  • AGG_SEARCH_PORTAL ポータルのプリセット( . 、例: codex.academic)。
    英語の原文を見るPortal preset ( . , e.g. codex.academic)
  • AGG_SEARCH_PROFILE ドメインプロファイルの上書き(general、academic、code、news)
    英語の原文を見るDomain profile override (general, academic, code, news)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Agg Search を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user agg-search --env EXA_API_KEY=your-value --env BRAVE_API_KEY=your-value --env SERPER_API_KEY=your-value --env MCP_ANYSEARCH_API_KEY=your-value --env FIRECRAWL_API_KEY=your-value --env TAVILY_API_KEY=your-value --env DEEPSEEK_API_KEY=your-value --env JINA_API_KEY=your-value -- uvx agg-search agg-search-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "agg-search": {
      "command": "uvx",
      "args": [
        "agg-search",
        "agg-search-mcp"
      ],
      "env": {
        "EXA_API_KEY": "your-value",
        "BRAVE_API_KEY": "your-value",
        "SERPER_API_KEY": "your-value",
        "MCP_ANYSEARCH_API_KEY": "your-value",
        "FIRECRAWL_API_KEY": "your-value",
        "TAVILY_API_KEY": "your-value",
        "DEEPSEEK_API_KEY": "your-value",
        "JINA_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "agg-search": {
      "command": "uvx",
      "args": [
        "agg-search",
        "agg-search-mcp"
      ],
      "env": {
        "EXA_API_KEY": "your-value",
        "BRAVE_API_KEY": "your-value",
        "SERPER_API_KEY": "your-value",
        "MCP_ANYSEARCH_API_KEY": "your-value",
        "FIRECRAWL_API_KEY": "your-value",
        "TAVILY_API_KEY": "your-value",
        "DEEPSEEK_API_KEY": "your-value",
        "JINA_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "agg-search": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "agg-search",
        "agg-search-mcp"
      ],
      "env": {
        "EXA_API_KEY": "your-value",
        "BRAVE_API_KEY": "your-value",
        "SERPER_API_KEY": "your-value",
        "MCP_ANYSEARCH_API_KEY": "your-value",
        "FIRECRAWL_API_KEY": "your-value",
        "TAVILY_API_KEY": "your-value",
        "DEEPSEEK_API_KEY": "your-value",
        "JINA_API_KEY": "your-value"
      }
    }
  }
}

自分で入力する値

  • EXA_API_KEY 秘密 必須 env
    Exa semantic search のキー
    英語の原文を見るExa semantic search key
  • BRAVE_API_KEY 秘密 必須 env
    Brave Search のキー
    英語の原文を見るBrave Search key
  • SERPER_API_KEY 秘密 必須 env
    Serper (Google SERP) key
  • MCP_ANYSEARCH_API_KEY 秘密 必須 env
    AnySearch のバッチ検索キー
    英語の原文を見るAnySearch batch search key
  • FIRECRAWL_API_KEY 秘密 必須 env
    Firecrawl search のキー
    英語の原文を見るFirecrawl search key
  • TAVILY_API_KEY 秘密 必須 env
    Tavily 検索キー
    英語の原文を見るTavily search key
  • DEEPSEEK_API_KEY 秘密 必須 env
    DeepSeek search および fetch のキー
    英語の原文を見るDeepSeek search and fetch key
  • JINA_API_KEY 秘密 必須 env
    Jina reranker のキー
    英語の原文を見るJina reranker key
  • SEARXNG_URL env
    セルフホスト型 SearXNG のベース URL
    英語の原文を見るSelf-hosted SearXNG base URL
  • AGG_SEARCH_PORTAL env
    ポータルのプリセット( . 、例: codex.academic)。
    英語の原文を見るPortal preset ( . , e.g. codex.academic)
  • AGG_SEARCH_PROFILE env
    ドメインプロファイルの上書き(general、academic、code、news)
    英語の原文を見るDomain profile override (general, academic, code, news)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
パソコンで動く
最新バージョンi
1.0.0
レジストリ公開日i
2026年11月21日
コードの最終更新i
2026年11月20日
作者
TsukimioRinka
パッケージ
pypi: agg-search
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月21日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント TsukimioRinka で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

まだ確認していません

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/tsukimiorinka-agg-search.svg)](https://mcp.popnx.com/en/servers/tsukimiorinka-agg-search)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

検索・AIの記憶のほかのサーバーとの比較i

  • このカテゴリのほかの6535件のうち77%よりスターが多い
  • このカテゴリのほかの6535件のうち99%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの6535件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Agg Searchは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(1.0.0)がレジストリに届いたのは今日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは?

同じカテゴリには:OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

作者:every-app広く使われている★ 2.8万7 日前更新

クラウドで動く✓ everyapp.com

Exa

Official Exa MCP for web search, content fetching, and multi-step research.

作者:exa-labs広く使われている★ 5245昨日更新

クラウドで動く✓ 提供元 · exa.aiPopNx チームが実際に試用

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

作者:MicrosoftDocs広く使われている★ 200212 か月前更新

クラウドで動く✓ 提供元 · microsoft.comPopNx チームが実際に試用

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

作者:proxysoul成長中★ 16293 か月前更新

クラウドで動く✓ empryo.com
似たものと比べる
これ
Agg Search
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいはいはいいいえいいえ
基本チェック3/35/52/44/44/44/4
ライセンスMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

agg-search

多引擎并行召回 + RRF 融合 + Jina 精排的搜索工具链:CLI + MCP server(stdio/HTTP)+ 分层抓取,宿主机零依赖(纯 Python 标准库)。

A multi-engine search stack for agents: parallel recall across eleven engines (three of them keyless domain sources), RRF fusion, listwise reranking, domain profiles, a local feedback loop, plus a tiered fetcher. Ships as a CLI and an MCP server — stdio, or streamable HTTP — with standard library only on the host.

*真实一次运行的输出:7 个引擎返回结果,DeepSeek 因余额不足进入冷却、被跳过;空结果不阻塞其余引擎。*


为什么又一个搜索聚合器

同类项目不少,但多数是「多引擎 + 简单合并」或「零 key 依赖单一索引」。这个项目的差异在六件事:

  1. DeepSeek 搜索/抓取是一等公民 —— 官方 /v1/tools/search 自带 rerank_score,/v1/tools/fetch 服务端取页直接给 Markdown,省掉容器。
  2. 抓取是阶梯而不是一个函数 —— DeepSeek Fetch → 静态 → 动态 → 反爬,逐级升级,跑在隔离容器里,宿主机不装浏览器。
  3. 排序是两阶段 —— RRF 粗排前 15,再交给 Jina Reranker v3.5 listwise 精排;模型不可用链式回退 v3 → v2,全失败则保留 RRF 顺序,绝不阻塞。
  4. 韧性层是显式的 —— 5 分钟结果缓存 + 15 分钟页面缓存、按错误类型分级的冷却(额度 1h / 反爬 10min / 超时 90s)、引擎健康与延迟上报,缺 key 的引擎提前剔除不占线程。
  5. 面向 Agent 的协议面 —— MCP 2025-06-18(含 outputSchema/structuredContent、tool annotations、版本协商)、stdio 与 streamable HTTP 两种传输、按调用计的硬超时与 notifications/cancelled、13 家客户端的配置生成器。
  6. 领域画像 + 本地反馈回路 —— --profile academic|code|news 换的是引擎组合、RRF 权重、默认时效与摘要长度(数据驱动,不改代码);search 记录哪些引擎召回了结果、fetch 记录哪些被真正读过,agg-search-tune 据此调整引擎权重,越用越贴合本机习惯。

架构

flowchart LR

subgraph clients[Agent clients] CC[Claude Code] CX[Codex] CU[Cursor] VS[VS Code] OC[OpenCode] end CC & CX & CU & VS & OC -->|stdio JSON-RPC| M[agg-search-mcp] CC & CU & VS -->|streamable HTTP| H[agg-search-http] M --> Q H --> Q[query expansion local ollama] Q --> A[exa] Q --> B[brave] Q --> C[serper] Q --> D[deepseek] Q --> E[firecrawl] Q --> F[anysearch] Q --> G[tavily] Q --> Hh[searxng] Q --> OA[openalex] Q --> HN[hn] Q --> ST[stack] A & B & C & D & E & F & G & Hh & OA & HN & ST --> R[RRF fusion profile weights × learned multipliers] R --> J[jina rerank v3.5 fallback v3 → v2] J --> O[top N results

  • provenance + health] O --> AN[optional cited answer]

安装

# PyPI(0.2.0 起)

uvx --from agg-search agg-search-mcp # 不落盘,直接跑

或者装成常驻命令(6 个入口:3 个 CLI + MCP stdio/HTTP + 安装器)

uv tool install agg-search

源码方式:

git clone https://github.com/TsukimioRinka/agg-search

cd agg-search uv pip install -e .

或者完全不安装:

PYTHONPATH=src python3 -m agg_search.search "query"

下载入口(Agent × 领域)

入口说明
docs/catalog.md13 家 Agent × 4 个领域画像的完整入口表
catalog.json同一份数据的机器可读版本(给脚本/目录站用)
docs/portals.md52 个 agent × domain 门户隔离规格(工具子集/顺序、prompt、依赖与降级)
portals.json机器可读门户注册表(与 catalog.json 严格同步)
Cursor / VS Code表里是一键深链,直接带上 AGG_SEARCH_PORTAL / AGG_SEARCH_PROFILE
Claude Code / Codex一条 mcp add 命令,含 --env
其他客户端agg-search-install --portal . --write
实测记录docs/agent-tests.md:6 个 CLI 客户端的门户隔离实测

非 general 画像注册为独立的 server 名(agg-search-academic、agg-search-code、agg-search-news),可以和默认的 agg-search 并存。

agg-search-install --portals --markdown   # 重新生成 docs/portals.md

agg-search-install --portals # 打印 portals.json agg-search-install --catalog --markdown # 重新生成 docs/catalog.md agg-search-install --catalog # 打印 catalog.json

使用

# 搜索

agg-search "rust async runtime comparison" --top-n 10 --recency month

域名过滤:只留 arxiv/.edu,去掉 reddit

agg-search "speculative decoding" --include-domains arxiv.org,.edu \ --exclude-domains reddit.com

机器可读输出(含引擎状态、延迟、冷却与过滤计数)

agg-search "MCP server examples" --json

RAG-Fusion 查询扩展(需要本地 ollama)

agg-search "vector database tradeoffs" --expand 3

带引用的答案段(本地 ollama;--answer deepseek 走 API)

agg-search "what changed in Python 3.13" --answer

快速模式:单池扇出,最早两个有结果的引擎就返回

agg-search "breaking news" --fast --budget-secs 20

诊断:打印生效配置(密钥只显示布尔值),或列出可用引擎

agg-search --show-config agg-search --help

抓取正文:DeepSeek Fetch 优先,失败落容器阶梯

crawl-fetch --url https://example.com/post --tier auto --out md

密钥只从环境变量读(也兼容 ~/.config/agent-env、~/.config/ai-keys.env 的 KEY= 行)。缺失的引擎会被跳过,不会让整次搜索失败。常用默认值可用 AGG_SEARCH_ENGINES、AGG_SEARCH_TOP_N、AGG_SEARCH_PER_ENGINE、AGG_SEARCH_SNIPPET_CHARS、AGG_SEARCH_FAST、AGG_SEARCH_NO_JINA、AGG_SEARCH_PROFILE、AGG_SEARCH_NO_LEARN 覆盖,命令行显式传参优先。完整变量表见 docs/environment.md。

MCP server

暴露工具按门户隔离(默认 search + fetch;academic 门户按 search -> fetch -> answer 暴露三件套):

工具主要参数说明
searchquery、top_n、recency、engines、portal、profile、include_domains、exclude_domains、snippet_chars、expand、answer、answer_fetch、fast、budget_secs、engine_timeout、no_jina并行召回 + 内容去重 + 权威先验 RRF + 精排;返回文本内容 + structuredContent
fetchurls、tier、out、text_limit分层抓取正文(SSRF 守卫由服务端环境变量控制);每 URL 一条结果
answerquery、sources、urls、mode、portal、profile仅在 academic 门户暴露;读取摘要或抓取全文,按 Agent 回退顺序合成带引用回答

协议行为:

  • 版本协商:2025-06-18 / 2025-03-26 / 2024-11-05,按客户端请求回选支持的版本。
  • 工具带 title、annotations(readOnlyHint、openWorldHint)和 outputSchema;支持结构化输出的客户端直接拿 structuredContent,老客户端仍拿文本。
  • 每个工具调用有硬墙钟(search 120s / fetch 300s),超时杀进程组;notifications/cancelled 同样会中断。
  • 工具调用在线程池里跑,ping/tools/list 不会被慢引擎卡住。
  • search 在 MCP 下默认 fast=true(有限的召回预算),fast=false 才等全部引擎。
一行接入
agg-search-install --list                     # 支持 13 家客户端

agg-search-install -c claude-code # 打印 claude mcp add 命令 agg-search-install -c cursor --write # 合并进 ~/.cursor/mcp.json(自动备份) agg-search-install -c vscode --scope project # 写 .vscode/mcp.json agg-search-install -c cursor --check # 校验文件、条目与运行时是否就绪

逐客户端的路径、JSON/TOML/YAML 片段与 GUI 环境变量陷阱见 docs/adapters.md。

HTTP 传输
agg-search-http --host 127.0.0.1 --port 8765 --path /mcp

多个客户端共用一个进程(共享缓存与冷却),默认只绑回环并校验 Host/Origin(防 DNS rebinding 与浏览器跨站请求),端点不带认证——对外必须先套反向代理。协议细节与 nginx 示例见 docs/http.md。

领域定向与每 agent 策略

agg-search "speculative decoding" --profile academic   # openalex 优先,摘要 500 字,top 15

agg-search "sqlite wal corrupt" --profile code # stack 优先,摘要 600 字 agg-search "release notes" --profile news --top-n 5 # 默认 recency=day agg-search --list-profiles

agg-search-install -c cursor --profile code --write # 把某个客户端钉在 code 画像上

同一套数据也通过 MCP 暴露:工具参数 profile,或环境变量 AGG_SEARCH_PROFILE。优先级 flag > env > profile > 内置默认;openalex / hn / stack 三个新引擎全部免 key,装好就能用。

反馈回路

search 记录每个结果由哪些引擎召回,fetch 成功读到其中某个 URL 时记一次「被使用」。 agg-search-tune 把 surfaced/used 折算成 0.5–2.0 的引擎权重乘数(样本少于 30 时保持 1.0), 之后所有搜索自动叠加,并进入缓存键——调权重不会命中旧结果。默认开启,--no-learn 或 AGG_SEARCH_NO_LEARN=1 关闭。

agg-search-tune --show   # 反馈表 + 当前乘数

agg-search-tune # 写入 ~/.config/agg-search/weights.json

只存哈希与计数,不存查询词、页面正文或原始 URL。机制与公式见 docs/profiles.md。

同类项目对比

只列能核实的能力,语言一列仅在仓库自述里明确时填写:

项目栈它强在哪与本项目的差别
search-cliRust13 个 provider,单一二进制本项目免编译;多容器抓取阶梯与 DeepSeek Fetch 是一等路径
web-search-mcpTypeScript注入防御( 包裹 + 隐藏字符剥离)、PDF/RSS/YouTube 抽取、本地语义重排、Recall@5 / MRR@10 评测、MCP resources/prompts它的内容抽取与提示注入防护比本项目完整;本项目的差异在 8 引擎并行 + RRF→Jina listwise、DeepSeek Search/Fetch、RAG-Fusion 与容器阶梯。SSRF 防护两边都有,本项目覆盖到抓取前置校验(见 docs/fetching.md)
argo—300+ 来源、18 语言、MCP/CLI本项目只做通用网页检索,覆盖面窄;差异在排序链路与成本控制更细
Tavily MCPTypeScript托管远端端点、search/extract/map/crawl 四件套、DEFAULT_PARAMETERS本项目可自带引擎、离线缓存与精排链,不绑定单一供应商
Brave MCPTypeScript官方索引,HTTP 传输带 Origin/Host 白名单本项目多引擎融合;传输层安全策略参考了它的做法
Exa MCPTypeScript托管端点 + OAuth、dynamic highlights本项目无托管依赖,密钥和缓存都在本机

测试

uv venv && uv pip install -e .

python3 -m unittest discover -s tests -v

220+ 个离线测试:门户隔离与降级、内容去重、权威先验、域名过滤、RRF、冷却分类、缓存键、SSRF 判定、安装器、MCP 协议面与 stdio/HTTP 端到端(不发起网络请求、不消耗额度)。CI 覆盖 Python 3.10–3.13 + ruff。

安全与隐私

  • 仓库内不含任何密钥、账号、内网地址;.env.example 只有空占位。
  • 密钥只在进程环境里读取,不写日志、不落盘;--show-config 只输出布尔值。
  • 抓取前置 SSRF 校验:仅 http(s)、无 userinfo、私网/回环/链路本地/云元数据地址默认拒绝(--allow-private 显式放开);响应体上限 4 MiB。
  • 抓取在容器内执行,宿主机不留浏览器与爬虫依赖。
  • 进入模型上下文的页面文本会剥离零宽与双向控制字符(隐藏指令的常见载体),MCP 指令块也声明页面内容为不可信数据。
  • HTTP 传输默认回环绑定 + Host/Origin 白名单,无认证时不得裸奔到公网。

文档

文档内容
docs/install.md安装方式、环境变量全表、冒烟测试
docs/adapters.md13 家客户端的接入配置
docs/http.mdHTTP 传输、安全模型、反向代理
docs/profiles.md领域画像、每 agent 策略、反馈回路与调参
docs/portals.md52 个 agent × domain 门户规格、工具顺序与降级路径
docs/benchmarks.md5 项增强机制的对照评测(18 领域 + 10 通用查询)与取舍依据
docs/agent-tests.md6 个 CLI 客户端的门户隔离实测与清理记录
docs/handoff.md交接:本机路径、凭据位置、逐层验证与发版流程
docs/fetching.md分层抓取的梯子与容器
docs/reranking.mdRRF 与 Jina 精排、参数扫描
docs/environment.md环境变量与计费说明

License

MIT