Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

Agg Search

by TsukimioRinkaversion 1.0.0i★ 1iRuns on your computerRepository ↗
Registry nameio.github.TsukimioRinka/agg-search

How to install

What it does

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

  • Connects Runs on your computer
  • Account or key Needs 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
  • Category Search & AI memory

Use together with

Skills that teach the AI this kind of work; they work alongside this one

timesfm

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

by google-research★ 35,6421 skills

Skill · How-to guide

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…

by BigBodyCobain★ 11,6081 skills

Skill · How-to guide

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

by gosom★ 8,2561 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity4/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score16/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Agg Search. Follow https://mcp.popnx.com/i/tsukimiorinka-agg-search.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 21, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a Agg Search key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Agg Search for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by 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) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For 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, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Agg Search tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Agg Search key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  4. Paste these settings and save the file

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

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Quit Claude and open it again

  6. Try it

    Use Agg Search and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Agg Search or shows a Agg Search tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • SEARXNG_URL Self-hosted SearXNG base URL
  • AGG_SEARCH_PORTAL Portal preset ( . , e.g. codex.academic)
  • AGG_SEARCH_PROFILE Domain profile override (general, academic, code, news)

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Agg Search yet

Agg Search runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Agg Search

  • You need a Agg Search key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • You need a Agg Search key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
  • You need a Agg Search key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
  • You need a Agg Search key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

B · Others in Search & AI memory that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

You need a Agg Search key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Agg Search for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by 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) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For 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, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Agg Search tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Agg Search key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  4. Paste this command and press 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

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Type /mcp in Claude Code

    You should see Agg Search listed as connected

  6. Try it

    Use Agg Search and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Agg Search or shows a Agg Search tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • SEARXNG_URL Self-hosted SearXNG base URL
  • AGG_SEARCH_PORTAL Portal preset ( . , e.g. codex.academic)
  • AGG_SEARCH_PROFILE Domain profile override (general, academic, code, news)

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a Agg Search key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Agg Search for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by 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) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For 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, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Agg Search tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Agg Search key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  4. Fill in your key

    In the Agg Search settings, 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 is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in Cursor in Agent mode

  6. Try it

    Use Agg Search and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Agg Search or shows a Agg Search tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • SEARXNG_URL Self-hosted SearXNG base URL
  • AGG_SEARCH_PORTAL Portal preset ( . , e.g. codex.academic)
  • AGG_SEARCH_PROFILE Domain profile override (general, academic, code, news)

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a Agg Search key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Agg Search for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by 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) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For 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, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Agg Search tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Agg Search key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  4. Fill in your key

    In the Agg Search settings, 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 is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in VS Code in Agent mode

  6. Try it

    Use Agg Search and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Agg Search or shows a Agg Search tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • SEARXNG_URL Self-hosted SearXNG base URL
  • AGG_SEARCH_PORTAL Portal preset ( . , e.g. codex.academic)
  • AGG_SEARCH_PROFILE Domain profile override (general, academic, code, news)

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Agg Search💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

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"
      }
    }
  }
}

Values you fill in

  • EXA_API_KEY secret required env
    Exa semantic search key
  • BRAVE_API_KEY secret required env
    Brave Search key
  • SERPER_API_KEY secret required env
    Serper (Google SERP) key
  • MCP_ANYSEARCH_API_KEY secret required env
    AnySearch batch search key
  • FIRECRAWL_API_KEY secret required env
    Firecrawl search key
  • TAVILY_API_KEY secret required env
    Tavily search key
  • DEEPSEEK_API_KEY secret required env
    DeepSeek search and fetch key
  • JINA_API_KEY secret required env
    Jina reranker key
  • SEARXNG_URL env
    Self-hosted SearXNG base URL
  • AGG_SEARCH_PORTAL env
    Portal preset ( . , e.g. codex.academic)
  • AGG_SEARCH_PROFILE env
    Domain profile override (general, academic, code, news)

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs on your computer
Latest versioni
1.0.0
Published to registryi
Nov 21, 2026
Code last changedi
Nov 20, 2026
Maker
TsukimioRinka
Packages
pypi: agg-search
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

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

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 21, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account TsukimioRinka, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed yesterday

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked yet

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

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

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Search & AI memoryi

  • More stars than 77% of the other 6535 servers in this category
  • Published to the registry more recently than 99% of the other 6535 servers in this category
  • Basic checks equal to or better than 99% of the other 6535 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Agg Search safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: 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

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (1.0.0) reached the registry today.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

OpenSEO

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

by every-appWidely used★ 28.4KUpdated 7 days ago

Runs in the cloud✓ everyapp.com

Exa

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

by exa-labsWidely used★ 5.2KUpdated yesterday

Runs in the cloud✓ service owner · exa.aiTried by the PopNx team

Microsoft Learn MCP

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

by MicrosoftDocsWidely used★ 2KUpdated 12 months ago

Runs in the cloud✓ service owner · microsoft.comTried by the PopNx team

Docs

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

by proxysoulGrowing★ 1.6KUpdated 3 months ago

Runs in the cloud✓ empryo.com
Compared with similar ones
This one
Agg Search
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyYesNoNoNoNoNo
Add with + in ClaudeNoYesYesYesNoNo
Basic checks3/35/52/44/44/44/4
LicenseMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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