Skip to main content
Glama
4cya

jupsearch-mcp

by 4cya
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

jupsearch-mcp

自托管的统一搜索与内容抽取 MCP Server。提供 web_search、read_url、extract_pdf、read_video 四个工具，通过 Exa、Serper、Tavily、Firecrawl、Jina 多渠道检索，并用 RRF 融合搜索结果。

要求

  • Node.js 24+

  • npm

Related MCP server: Universal Web Retrieval MCP

配置

cp .env.example .env

SEARCH_PROVIDERS 决定搜索渠道顺序，READ_PROVIDERS 决定网页/PDF 读取渠道顺序。未设置 key 的渠道会被跳过，单个渠道失败不会影响其他渠道。

HOST 默认 127.0.0.1，PORT 默认 8790。

访问鉴权

/mcp 要求固定 token。token 放在 MCP_AUTH_TOKEN（部署环境里由 systemd 的 EnvironmentFile 提供），明文留存在服务器的 .mcp-token（权限 600）。未配置 MCP_AUTH_TOKEN 时 /mcp 一律返回 503，不会退回无鉴权模式。

客户端两种携带方式（二选一，推荐第一种）：

X-MCP-Token: <token>
Authorization: Bearer <token>

GET /health 不需要 token，只返回渠道名与 configured 布尔值，不含任何凭据。

本地运行

npm install
npm run build
npm start

服务默认监听 http://127.0.0.1:8790/mcp，健康检查为 GET /health。

测试

npm test

MCP 客户端配置

Streamable HTTP 地址：

http://127.0.0.1:8790/mcp

MCP 客户端配置（HTTP 传输，带鉴权头）：

{
  "mcpServers": {
    "jupsearch": {
      "type": "http",
      "url": "https://search.711255.xyz/mcp",
      "headers": { "X-MCP-Token": "<token>" }
    }
  }
}

用 curl 直接验证：

TOKEN=$(cat /opt/jupsearch-mcp/.mcp-token)
curl -sS -X POST https://search.711255.xyz/mcp \
  -H "X-MCP-Token: $TOKEN" \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

web_search 参数：

  • query：必填，搜索词

  • max_results：可选，返回结果上限，1-20，默认 10

返回结果包含 results、attempted、succeeded、failed、skipped；每条结果通过 sources 保留渠道溯源。

read_url

抓取公开网页并返回 Markdown。渠道链默认 firecrawl,exa,jina，即 READ_PROVIDERS 的值。

  • url：必填，公开网页地址

  • max_characters：可选，返回内容上限，1-100000，默认 20000

extract_pdf

抽取公开 PDF 的文本并返回 Markdown。请求参数和渠道链与 read_url 相同。

read_video

抽取视频页面的标题、描述、章节等可见内容。渠道链固定为 jina,firecrawl，不受 READ_PROVIDERS 控制。

本工具不提供字幕或音视频转写：上游渲染、站点鉴权或渠道能力可能使字幕不可得，返回中的 warnings 会如实标注原因，不伪造字幕。引入 yt-dlp / ffmpeg 等额外系统依赖不在当前范围。

三个读取工具均返回 result、attempted、succeeded、failed、skipped。result 包含 title、url、content、provider、kind 和可选的 warnings。

渠道

渠道

搜索端点

读取端点

exa

https://api.exa.ai/search

https://api.exa.ai/contents

serper

https://google.serper.dev/search

-

tavily

https://api.tavily.com/search

-

firecrawl

https://api.firecrawl.dev/v2/search

https://api.firecrawl.dev/v2/scrape

jina

https://s.jina.ai/

https://r.jina.ai/

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

  • MESSORAA
    dev.messora

    Scrape, crawl and search the web for AI agents via MCP.

    Web ScrapingBrowser AutomationSearch
    1
  • pixserpA
    com.pixserp

    Live AI-native web search with citations. One tool for every MCP client. Flat per-request pricing.

    SearchBrowser Automation
    12
  • ReplyNodesC
    com.replynodes

    Web MCP: scrape/crawl sites, web search, brand assets, app stores, YouTube, Reddit, Hacker News.

    Browser AutomationWeb ScrapingSearch
    7114
  • AIsa Web Search & ResearchCOAuth
    one.aisa

    Your agent needs the open web — searched by more than one engine, and read as clean markdown rather than raw HTML. **What you can ask for** • "Search this question with two providers and tell me where they disagree." • "Scrape these 40 URLs into markdown, in one batch." • "Crawl this documentation site and give me every page." • "Do deep research on this topic and cite the sources." • "Find the academic papers behind this claim." **How to use it** Point any MCP client at https://mcp.aisa.one/search/mcp and sign in with OAuth — there is no key to create or paste. 30 tools across several independent providers: Tavily and Exa search, answers, contents and agent runs; Firecrawl scrape, batch scrape, crawl, map and search; Perplexity Sonar, Sonar Pro, reasoning and deep research; Oxylabs AI search and LLM jobs; OpenAI and Anthropic web search; and scholarly search. **Why this rather than the source** Several independent indexes behind one account, because one engine's blind spot is not visible from inside it. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Find the page here, then ask the same agent who links to it or how much traffic it gets — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/seo-serp/mcp for the Google results page itself, https://mcp.aisa.one/seo-serp-other-engines/mcp for Bing, Baidu and Naver.

    Browser AutomationSearchWeb Scraping
    351

Related MCP Servers

  • Universal Web Retrieval MCP

    withgardener
    A
    license
    A
    quality
    A
    maintenance
    Enables MCP-capable agents to perform reliable web search and content fetching through a single server that automatically fails over across multiple providers. It handles keyed or keyless authentication automatically and returns clean Markdown or text results.
    2
    1
    MIT

  • Qianxv-search-mcp

    Limx1994
    F
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP clients to run local web searches with automatic failover across multiple search providers and to extract public web pages as titles and Markdown content, using circuit breaking and key-redacted logging.
    -

  • Alka Search MCP

    alkasima
    A
    license
    A
    quality
    C
    maintenance
    Free web search, web-page reading as Markdown, and llms.txt documentation retrieval for MCP clients. Runs locally with Node.js over stdio using @alkasima/alka-search-mcp. Searches DuckDuckGo, Mojeek, and Brave; default providers require no API key. Website and provider availability may vary.
    8
    3
    MIT