# Exa MCP 服务器 🔍
[](https://www.npmjs.com/package/exa-mcp-server)
[](https://smithery.ai/server/exa)
## 🆕 `exa-code`: 适用于编程代理的快速高效网络上下文
氛围编程不应该有糟糕的氛围。`exa-code` 是编程代理永不产生幻觉的巨大一步。
当您的编程代理进行搜索查询时,`exa-code` 会搜索数十亿个 Github 仓库、文档页面、Stackoverflow 帖子等,以找到代理正确编写代码所需的完美、token 高效的上下文。它由 Exa 搜索引擎提供支持。
您可以使用 `exa-code` 进行的查询示例:
* 在 Python 中使用 Exa 搜索,并确保内容始终是实时抓取的
* 使用 Vercel AI SDK 的正确语法调用 gpt-5 nano 询问它“你好吗”
* 如何设置可重现的 Nix Rust 开发环境
**✨ 适用于 Cursor 和 Claude Code!** 使用基于 HTTP 的配置格式:
```json
{
"mcpServers": {
"exa": {
"type": "http",
"url": "https://mcp.exa.ai/mcp",
"headers": {
"Remove-Me": "如果您只是在编码,请禁用 web_search_exa 工具。要 100% 调用 exa-code,请说“使用 exa-code”。"
}
}
}
}
```
您可以像这样在 URL 中包含您的 Exa API 密钥:
```
https://mcp.exa.ai/mcp?exaApiKey=YOUREXAKEY
```
您可以使用 `enabledTools` 参数在 URL 中将特定工具列入白名单,该参数需要 URL 编码的字符串数组,如下所示:
```
https://mcp.exa.ai/mcp?exaApiKey=YOUREXAKEY&enabledTools=%5B%22crawling_exa%ss%5D
```
您还可以通过 [Smithery](https://smithery.ai/server/exa) 使用 `exa-code`,无需 Exa API 密钥。
---
一个模型上下文协议 (MCP) 服务器,它将 Claude 等 AI 助手连接到 Exa AI 的搜索功能,包括网络搜索、研究工具和我们新的代码搜索功能。
## 远程 Exa MCP 🌐
直接连接到 Exa 托管的 MCP 服务器(而不是在本地运行)。
### 远程 Exa MCP URL
```
https://mcp.exa.ai/mcp
```
### 适用于远程 MCP 的 Claude Desktop 配置
将此添加到您的 Claude Desktop 配置文件中:
```json
{
"mcpServers": {
"exa": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.exa.ai/mcp"
]
}
}
}
```
### 适用于远程 MCP 的 Cursor 和 Claude Code 配置
对于 Cursor 和 Claude Code,请使用此基于 HTTP 的配置格式:
```json
{
"mcpServers": {
"exa": {
"type": "http",
"url": "https://mcp.exa.ai/mcp",
"headers": {}
}
}
}
```
### NPM 安装
```bash
npm install -g exa-mcp-server
```
### 使用 Claude Code
```bash
claude mcp add exa -e EXA_API_KEY=YOUR_API_KEY -- npx -y exa-mcp-server
```
### 通过 Smithery 使用 Exa MCP
要通过 [Smithery](https://smithery.ai/server/exa) 安装 Exa MCP 服务器,请访问:
[smithery.ai/server/exa](https://smithery.ai/server/exa)
## 配置 ⚙️
### 1. 配置 Claude Desktop 以识别 Exa MCP 服务器
您可以在 Claude Desktop 应用程序的设置中找到 `claude_desktop_config.json`:
打开 Claude Desktop 应用程序,并从左上角的菜单栏中启用开发者模式。
启用后,打开设置(也在左上角的菜单栏中),然后导航到开发者选项,在那里您会找到“编辑配置”按钮。单击它将打开 `claude_desktop_config.json` 文件,允许您进行必要的编辑。
或者(如果您想从终端打开 `claude_desktop_config.json`)
#### 对于 macOS:
1. 打开您的 Claude Desktop 配置:
```bash
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```
#### 对于 Windows:
1. 打开您的 Claude Desktop 配置:
```powershell
code %APPDATA%\Claude\claude_desktop_config.json
```
### 2. 添加 Exa 服务器配置:
```json
{
"mcpServers": {
"exa": {
"command": "npx",
"args": ["-y", "exa-mcp-server"],
"env": {
"EXA_API_KEY": "your-api-key-here"
}
}
}
}
```
将 `your-api-key-here` 替换为您在 [dashboard.exa.ai/api-keys](https://dashboard.exa.ai/api-keys) 上的实际 Exa API 密钥。
### 3. 可用工具和工具选择
Exa MCP 服务器包含适用于开发人员和研究人员的强大工具:
#### 🔥 **特色:代码搜索工具**
- **get_code_context_exa**: 🆕 **新增!** 搜索并获取来自开源库、GitHub 仓库和编程框架的相关代码片段、示例和文档。非常适合查找最新的代码文档、实现示例、API 使用模式和真实代码库中的最佳实践。
#### 🌐 **其他可用工具**
- **web_search_exa**: 执行实时网络搜索,提供优化结果和内容提取。
- **company_research**: 全面的公司研究工具,抓取公司网站以收集有关企业的详细信息。
- **crawling**: 从特定 URL 提取内容,当您拥有确切的 URL 时,可用于阅读文章、PDF 或任何网页。
- **linkedin_search**: 使用 Exa AI 搜索 LinkedIn 上的公司和人员。只需在查询中包含公司名称、人员姓名或特定的 LinkedIn URL。
- **deep_researcher_start**: 启动一个智能 AI 研究员,用于解决复杂问题。AI 将搜索网络,阅读大量来源,并深入思考您的问题以创建详细的研究报告。
- **deep_researcher_check**: 检查您的研究是否准备就绪并获取结果。在启动研究任务后使用此功能,以查看是否已完成并获取您的综合报告。
您可以通过向 Claude Desktop 配置添加 `--tools` 参数来选择要启用的工具:
#### 💻 **仅代码搜索设置**(推荐给开发人员)
```json
{
"mcpServers": {
"exa": {
"command": "npx",
"args": [
"-y",
"exa-mcp-server",
"--tools=get_code_context_exa,web_search_exa"
],
"env": {
"EXA_API_KEY": "your-api-key-here"
}
}
}
}
```
#### 指定要启用的工具:
```json
{
"mcpServers": {
"exa": {
"command": "npx",
"args": [
"-y",
"exa-mcp-server",
"--tools=get_code_context_exa,web_search_exa,company_research,crawling,linkedin_search,deep_researcher_start,deep_researcher_check"
],
"env": {
"EXA_API_KEY": "your-api-key-here"
}
}
}
}
```
要启用多个工具,请使用逗号分隔列表:
```json
{
"mcpServers": {
"exa": {
"command": "npx",
"args": [
"-y",
"exa-mcp-server",
"--tools=get_code_context_exa,web_search_exa,company_research,crawling,linkedin_search,deep_researcher_start,deep_researcher_check"
],
"env": {
"EXA_API_KEY": "your-api-key-here"
}
}
}
}
```
如果您未指定任何工具,则将使用默认启用的所有工具。
### 4. 重启 Claude Desktop
要使更改生效:
1. 完全退出 Claude Desktop(不只是关闭窗口)
2. 再次启动 Claude Desktop
3. 查找图标以验证 Exa 服务器是否已连接
## 通过 NPX 使用
如果您更喜欢直接运行服务器,可以使用 npx:
```bash
# 运行并默认启用所有工具
npx exa-mcp-server
# 仅启用特定工具
npx exa-mcp-server --tools=web_search_exa
# 启用多个工具
npx exa-mcp-server --tools=web_search_exa,get_code_context_exa
# 列出所有可用工具
npx exa-mcp-server --list-tools
```
---
由 Exa 团队 ❤️ 打造