Exa MCP服务器🔍
模型上下文协议（MCP）服务器允许像Claude这样的人工智能助手使用Exa人工智能搜索API进行网络搜索。这种设置允许AI模型以安全和可控的方式获取实时网络信息。
远程检查MCP🌐
直接连接到Exa的托管MCP服务器（而不是在本地运行）。
远程考试MCP URL
https://mcp.exa.ai/mcp?exaApiKey=your-exa-api-key替换 your-api-key-here 使用来自的Exa API密钥 dashboard.exa.ai/api-keys.
远程MCP的Claude桌面配置
将此添加到您的Claude Desktop配置文件中：
{
"mcpServers": {
"exa": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.exa.ai/mcp?exaApiKey=your-exa-api-key"
]
}
}
}NPM安装
npm install -g exa-mcp-server使用克劳德代码
claude mcp add exa -e EXA_API_KEY=YOUR_API_KEY -- npx -y exa-mcp-server使用Smithery
通过以下方式自动安装Claude Desktop的Exa MCP服务器 史密瑟里:
npx -y @smithery/cli install exa --client claude配置⚙️
1.配置Claude Desktop以识别Exa MCP服务器
您可以在claude desktop应用程序的设置中找到claude_desktop_config.json：
打开Claude Desktop应用程序，从左上角菜单栏启用开发人员模式。
启用后，打开“设置”（也是从左上角菜单栏），导航到“开发人员选项”，您将在其中找到“编辑配置”按钮。点击它将打开claude_desktop_config.json文件，允许您进行必要的编辑。
或者（如果你想从终端打开claude_desktop_config.json）
对于macOS：
- 打开您的Claude Desktop配置：
code ~/Library/Application\ Support/Claude/claude_desktop_config.json对于Windows：
- 打开您的Claude Desktop配置：
code %APPDATA%\Claude\claude_desktop_config.json2.添加Exa服务器配置：
{
"mcpServers": {
"exa": {
"command": "npx",
"args": ["-y", "exa-mcp-server"],
"env": {
"EXA_API_KEY": "your-api-key-here"
}
}
}
}替换 your-api-key-here 使用来自的Exa API密钥 dashboard.exa.ai/api-keys.
3.可用工具和工具选择
Exa MCP服务器包括以下工具，可以通过添加 --tools:
- web_search_exa：执行实时网络搜索，优化结果和内容提取。
- 公司_研究：全面的公司研究工具，可抓取公司网站以收集有关企业的详细信息。
- 爬行：从特定URL中提取内容，当您有确切的URL时，可用于阅读文章、PDF或任何网页。
- linkedin_search：使用Exa AI在领英搜索公司和个人。只需在查询中包含公司名称、人名或特定的领英网址。
- 深度搜索开始：为复杂的问题启动一个聪明的人工智能研究人员。人工智能将搜索网络，阅读许多来源，并深入思考您的问题，以创建详细的研究报告。
- deep_researcher_check：检查你的研究是否准备好了，并得到结果。在开始一项研究任务后使用此工具，看看它是否已经完成，并得到你的综合报告。
您可以通过添加来选择要启用的工具 --tools Claude Desktop配置的参数：
指定要启用的工具：
{
"mcpServers": {
"exa": {
"command": "npx",
"args": [
"-y",
"exa-mcp-server",
"--tools=web_search_exa,company_research,crawling,linkedin_search,deep_researcher_start,deep_researcher_check"
],
"env": {
"EXA_API_KEY": "your-api-key-here"
}
}
}
}要启用多个工具，请使用逗号分隔的列表：
{
"mcpServers": {
"exa": {
"command": "npx",
"args": [
"-y",
"exa-mcp-server",
"--tools=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（不仅仅是关闭窗口）
- 重新启动克劳德桌面
- 查找图标以验证Exa服务器是否已连接
通过NPX使用
如果你更喜欢直接运行服务器，你可以使用npx：
# Run with all tools enabled by default
npx exa-mcp-server
# Enable specific tools only
npx exa-mcp-server --tools=web_search_exa
# Enable multiple tools
npx exa-mcp-server --tools=web_search_exa,company_research
# List all available tools
npx exa-mcp-server --list-tools故障排除🔧
常见问题
- 找不到服务器
- 验证npm链接是否设置正确 - 检查Claude Desktop配置语法（json文件）
- API关键问题
- 确认您的EXA_API_KEY有效 - 检查在Claude Desktop配置中是否正确设置了EXA_API_KEY - 验证API键周围没有空格或引号
- 连接问题
- 完全重新启动克劳德桌面 - 检查克劳德桌面日志：
______________________________________________________________________
内置于❤️ 通过团队Exa
部署到Heroku🚀
您可以使用Heroku按钮一键将此MCP服务器部署到Heroku：
手动Heroku部署
如果您更喜欢手动部署：
- 克隆此存储库：
git clone https://github.com/dsouza-anush/exa-mcp-server-heroku.git
cd exa-mcp-server-heroku- 创建一个新的Heroku应用程序：
heroku create- 将Exa API密钥设置为配置变量：
heroku config:set EXA_API_KEY=your-api-key-here- （可选）指定要启用的工具：
heroku config:set ENABLED_TOOLS=web_search_exa,company_research_exa,crawling_exa- 部署到Heroku：
git push heroku main与Heroku推理和代理一起使用🤖
此MCP服务器与Heroku托管推理和代理完全兼容。要使用它：
- 使用上述步骤将MCP服务器部署到Heroku。
- 将MCP服务器连接到Heroku管理推理和代理聊天模型：
# Replace APP_NAME with your Heroku app name
# Replace MODEL_NAME with your desired model name
heroku ai:models:create MODEL_NAME -a APP_NAME --as INFERENCE- 您的MCP服务器将自动向Heroku Inference注册，其工具将通过
/v1/agents/heroku终点。
MCP服务器配置
此服务器对Heroku推理使用以下Procfile配置：
web: npm run serve
mcp-search-exa: node ./stdio-server.js这 mcp-search-exa 进程按照Heroku要求的命名约定（进程名称必须以“mcp”开头）在Heroku推理中注册。直接执行Node.js可确保MCP协议的正确stdio处理。
根据Heroku对mcp服务器的建议，在app.json中默认情况下，web和mcp搜索exa-dynos都配置为扩展到0。当您将此应用程序附加到Heroku推理模型时，Heroku将根据工具执行的需要自动扩展MCP流程。
与Claude Desktop一起使用
要将Heroku部署的MCP服务器与Claude Desktop一起使用：
- 将此添加到您的Claude Desktop配置文件中：
{
"mcpServers": {
"exa_heroku": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://your-app-name.herokuapp.com/mcp"
],
"env": {
"EXA_API_KEY": "your-api-key-here"
}
}
}
}替换 your-app-name 使用您的Heroku应用程序名称和 your-api-key-here 使用Exa API密钥。
与Claude Code CLI一起使用
claude mcp add exa_heroku -e EXA_API_KEY=YOUR_API_KEY -- npx -y mcp-remote https://your-app-name.herokuapp.com/mcp替换 your-app-name 使用您的Heroku应用程序名称和 YOUR_API_KEY 使用Exa API密钥。
与上游保持同步🔄
此存储库 每天自动更新 从原始的exa-mcp服务器存储库中删除，同时保留所有Heroku特定的自定义设置。更新是通过GitHub Actions处理的。
自动更新
GitHub Actions工作流每天运行，以：
- 从原始exa-mcp服务器存储库获取最新更改
- 保留所有Heroku特定的自定义设置（app.json、Procfile等）
- 提交并推送更新的代码
您还可以通过以下方式手动触发更新：
- 转到GitHub存储库中的“操作”选项卡
- 选择“上游自动更新”工作流
- 点击“运行工作流”
手动更新
如果您更喜欢手动更新，可以使用附带的更新脚本：
- 克隆您的分叉存储库：
git clone https://github.com/your-username/exa-mcp-server-heroku.git
cd exa-mcp-server-heroku- 运行更新脚本：
./update-from-upstream.sh- 查看更改，然后提交并推送到您的存储库：
git commit -am "Updated from upstream with Heroku customizations"
git push origin main- 如果您已经部署到Heroku，请更新您的Heroku应用程序：
git push heroku main更新过程保留了所有Heroku特定的自定义设置，包括：
- Heroku按钮配置（app.json）
- 过程定义（Procfile）
- 环境变量处理
- Heroku特定脚本
- 部署说明