Exa MCP ServerExa MCP Server
Exa 官方 MCP server(MIT):默认就两工具——web_search_exa 搜索、web_fetch_exa 读正文, 干净 markdown 直供 agent。匿名就能连(限流),OAuth/API key 提额并解锁 Exa Agent 多步研究。 诚实标注:GitHub releases 为空,发版线在 npm;advanced search 与 agent_run 要 ?tools= 显式开。
Exa's official MCP server (MIT): two default tools — web_search_exa and web_fetch_exa, clean markdown straight to the agent. Anonymous access works (rate-limited); OAuth/API key raises limits and unlocks the multi-step Exa Agent. Honest note: GitHub releases is empty, the release line is npm; advanced search and agent_run need explicit ?tools= opt-in.
适合与不适合When to use it, when not to
适合:要「搜索+读正文」二合一的检索面、零门槛接入、多步研究 Agent 进阶面。 不适合:站点级爬取编排(firecrawl 线);完全离线场景。
Fits: a combined search+read retrieval lane, zero-barrier onboarding (anonymous works), the multi-step research Agent as the advanced lane. Not a fit: site-level crawl orchestration (that is the firecrawl line); fully offline setups.
中文生态China availability 国产 / 国内可直接用 / 备案状态 · 快照domestic / direct access / CAC filing · snapshot 2026-10-23
- 出品属地Origin
- 国外出品foreign-made Exa(前 Metaphor Systems,美国)。Exa (formerly Metaphor Systems, US).
- 国内使用Direct access
- 直连不可达direct blocked exa.ai 与 mcp.exa.ai 直连实测 000(网络受限,非死链);GitHub 仓与 raw README 经代理 200(2026-10-23)。exa.ai and mcp.exa.ai measured 000 direct (network restricted, not dead); the GitHub repo and raw README returned 200 via proxy (2026-10-23).
- 备案状态CAC filing
- 未见于备案名单not in filing list:未见于网信办公示名单(2026-10-23 检索);该产品未面向大陆公众提供服务,备案不适用。not in the CAC public registry (searched 2026-10-23); the product does not serve the mainland public, so filing does not apply.
备案信息以网信办《生成式人工智能服务已备案信息》公示名单为准(按批次滚动更新,本站只抄编号不解读);「大陆可直连」是本站从大陆网络直连实测的结果,不是厂商承诺。GitHub 类站点当日实测有波动,口径写在依据里。Filing status is quoted from the CAC public registry (updated batch by batch; this site copies the number and does not interpret it). "Direct access" is this site's own reachability measurement from a mainland network, not a vendor promise. GitHub-hosted sites fluctuated on the measurement day — the note says so.
固定坐标系Fixed coordinate system
11 个维度dimensions, 与同分区其他对象逐项可比each comparable item by item against others in the same section.
- 模型与开放条件Model & openness
它自己不调模型——被 MCP 客户端调用的接口实现。它把 Exa 的检索与抓取 (web search、网页正文、多步研究 Agent)包装成工具给 agent 用。
It calls no model itself — an interface implementation called by MCP clients. It wraps Exa's retrieval and fetching (web search, web page text, multi-step research Agent) as tools for agents.
- 运行位置Where it runs
官方托管远程 server(https://mcp.exa.ai/mcp,streamable-http)为主; 仓同时是 Agent Plugin(agent-plugins.org 生态)与 Claude/Codex 插件线。 GitHub 5,162★,最近推送 2026-10-19(API 核验);GitHub releases 为空, 发版线在 npm(exa-mcp-server 3.4.2)。
Mainly the official hosted remote server (https://mcp.exa.ai/mcp, streamable-http); the repo doubles as an Agent Plugin (agent-plugins.org ecosystem) and a Claude/Codex plugin line. GitHub 5,162★, last push 2026-10-19 (API verified); GitHub releases are empty, the release line lives on npm (exa-mcp-server 3.4.2).
- 本地文件Local files
不读写本机文件——输出检索结果与网页正文(clean markdown)。
Reads and writes no local files — it outputs search results and web page text (clean markdown).
- 关机后的任务Tasks after shutdown
服务在 Exa 侧;会话请求-响应,无后台监听语义。
The service lives on Exa's side; session request-response, no background-listening semantics.
- 工具与扩展Tools & extensions
默认两工具:web_search_exa(搜索取干净内容)、web_fetch_exa(按 URL 读全文 markdown); 可选工具经 URL 参数 ?tools= 开启:web_search_advanced_exa(过滤/域名/日期/子页爬取)、 agent_run(Exa Agent 多步研究/列表构建/结构化输出)。 仓内 skills/ 目录带 search 与 exa-agent 两个 Agent Skill(插件安装时装载)。
Two tools by default: web_search_exa (search for clean content), web_fetch_exa (read full-page markdown by URL); optional tools are enabled via the URL parameter ?tools=: web_search_advanced_exa (filters/domains/dates/subpage crawling), agent_run (Exa Agent multi-step research / list building / structured output). The repo's skills/ directory ships two Agent Skills, search and exa-agent (loaded when the plugin is installed).
- 上下文与记忆Context & memory
无 server 侧跨会话记忆——每次检索独立;多步状态在 Exa Agent 任务内。
No server-side cross-session memory — each retrieval is independent; multi-step state lives inside the Exa Agent task.
- 权限与限制Permissions & limits
匿名可用:托管端点匿名接入带速率限制(官方 README 口径); 提额与 Exa Agent 要 OAuth(推荐,客户端弹登录)或 API key (?exaApiKey= 参数 / Authorization Bearer / x-api-key 三种传法)。 纯读面——不能写任何系统,风险面是查询内容外发与配额。
Usable anonymously: the hosted endpoint accepts anonymous connections with rate limits (official README wording); higher quotas and Exa Agent require OAuth (recommended, the client pops a login) or an API key (three ways: ?exaApiKey= parameter / Authorization Bearer / x-api-key). Purely read-only surface — it cannot write to any system; the risk surface is query content leaving your machine and quota.
- 适合什么任务Best for
适合:给 agent 一路「搜索+读正文」二合一的检索面(默认两工具就覆盖)、 零门槛接入(匿名可用)、要多步研究 Agent 的进阶面。 不适合:要深度站点级爬取编排(crawl/map 这类面在 firecrawl 线); 要完全离线(托管线要连 Exa)。
Fits: giving an agent one route with a combined "search + read text" retrieval surface (the two default tools cover it), zero-barrier onboarding (anonymous works), and the advanced multi-step research Agent surface. Not a fit: deep site-level crawl orchestration (the crawl/map surface lives in the firecrawl line); fully offline use (the hosted line needs to reach Exa).
- 传输方式Transport
streamable-http(https://mcp.exa.ai/mcp);经 Agent Plugin / Claude / Codex 插件线安装时同一托管端点。核验:仓 README(2026-10-23 直抓)。
streamable-http (https://mcp.exa.ai/mcp); the same hosted endpoint when installed via the Agent Plugin / Claude / Codex plugin lines. Verified: repo README (fetched directly 2026-10-23).
- 认证机制Authentication
匿名可用(限流);OAuth 优先(?login 或 /oauth 强制登录流); API key 可走 ?exaApiKey= 查询参数、Authorization Bearer 或 x-api-key 头。
Anonymous works (rate-limited); OAuth first (?login or /oauth force the login flow); API key can go through the ?exaApiKey= query parameter, Authorization Bearer, or the x-api-key header.
- 权限范围Permission scope
纯读:搜索族 + 网页读取 + 研究 Agent。无写面;无审批需求。
Purely read: search family + web page reading + research Agent. No write surface; no approval needs.
头号误解Top misconception
- 只看到默认两工具——advanced search 与 agent_run 要经 ?tools= 参数显式开启,且会替换默认集(官方 README:include all you want)Seeing only the two default tools — advanced search and agent_run require the ?tools= URL parameter, which REPLACES the default set (README: include all you want)
- 把 GitHub releases 当发版线——该仓 releases 为空,现役版本在 npm(exa-mcp-server)Treating GitHub releases as the release line — that repo's releases are empty; the live version is on npm (exa-mcp-server)
- 匿名档当正式档——匿名可用但限流;Exa Agent 必须鉴权(OAuth 或 key)Treating the anonymous tier as production — anonymous works but is rate-limited; Exa Agent requires auth (OAuth or key)
- 把「搜索」与「整站爬取」混为一谈——它给检索与单页正文,站点级 crawl/map 不是它的形态Confusing "search" with "whole-site crawling" — it gives retrieval and single-page content; site-level crawl/map is not its shape
未知项清单Known unknowns
- 匿名档与鉴权档的速率限制具体数值(官方 README 只说 rate limits,未逐条核验;按快照纪律不记数字)
- Exa Agent 的工具面与 Connect providers 细节(README 指向 docs.exa.ai,未逐页核验)
- Agent Plugin 生态的兼容客户端清单(README 引 agent-plugins.org,未逐条核验)
- The exact rate limits of the anonymous vs authenticated tiers (the official README only says "rate limits", not verified item by item; per snapshot discipline no numbers are recorded)
- The Exa Agent tool surface and Connect providers details (README points to docs.exa.ai, not verified page by page)
- The compatible-client list of the Agent Plugin ecosystem (README cites agent-plugins.org, not verified item by item)
证据来源Evidence sources
判断可回到以下一手源复核。本站核验日Every judgement can be rechecked against the primary sources below. Verified on 2026-10-23,内容更新日content updated on 2026-10-23。
| 类型Type | 名称Name | 链接Link |
|---|---|---|
| repo | exa-labs/exa-mcp-server · 仓库(MIT;5,162★,最近推送 2026-10-19,GitHub API 核验)exa-labs/exa-mcp-server · repository (MIT; 5,162★, last push 2026-10-19, GitHub API verified) | https://github.com/exa-labs/exa-mcp-server |
| changelog | npm · exa-mcp-server(发版线:GitHub releases 为空,npm 3.4.2 为最新)npm · exa-mcp-server (release line: GitHub releases are empty, npm 3.4.2 is latest) | https://www.npmjs.com/package/exa-mcp-server |
| docs | Exa · 官方 MCP 文档(仓 homepage 字段指向;直抓 000 网络受限,未逐页核验)Exa · official MCP docs (pointed to by the repo homepage field; direct fetch returned 000 network-restricted, not page-verified) | https://exa.ai/docs/reference/exa-mcp |
实测记录Measured runs
本档未在真实客户端逐项跑通;工具清单与权限来自官方 README。
This site has not completed measured runs. The test protocol is at protocols/mcp/_protocol.md.
相关条目Related entries
- Firecrawl MCPFirecrawl MCP Server同为检索+抓取官方 server:Exa 默认极简两工具,Firecrawl 是 27 工具的全家桶面。Also an official retrieval+fetch server: Exa defaults to a minimal two tools, Firecrawl is a 27-tool full-family surface.
- Fetch MCP ServerFetch MCP Server检索↔抓取分工对照:fetch 是 reference 级单页读取,Exa 把搜索与读取打包成一路。A retrieval↔fetch division-of-labor contrast: fetch is reference-level single-page reading, Exa packages search and reading into one route.
- CursorCursor另一层 · AI 编程Other layer · AI coding
- Claude Code IDE 扩展Claude Code (IDE extension)另一层 · AI 编程Other layer · AI coding
本页由This page is generated from the ai-handbook 数据层生成(CC BY 4.0)。data layer (CC BY 4.0).
方法论与坐标系定义见仓库内For the methodology and coordinate definitions, see METHODOLOGY.md.