Exa MCP Server - AI 搜索服务中间件
本文翻译整理自：https://github.com/exa-labs/exa-mcp-server
一、关于 Exa MCP Server
Exa MCP Server 是一个模型上下文协议（Model Context Protocol）服务，允许 Claude 等 AI 助手通过 Exa AI Search API 执行网页搜索。该服务为 AI 模型提供安全可控的实时网络信息获取能力。
演示视频：https://www.loom.com/share/ac676f29664e4c6cb33a2f0a63772038?sid=0e72619f-5bfc-415d-a705-63d326373f60
相关链接资源
- github : https://github.com/exa-labs/exa-mcp-server
- npm : https://www.npmjs.com/package/exa-mcp-server
- 官网：https://exa.ai
- API密钥管理：https://dashboard.exa.ai/api-keys
- Smithery 自动安装：https://smithery.ai/server/exa
- Model Context Protocol 规范：https://modelcontextprotocol.io
关键功能特性
1、支持通过 Exa API 执行网页搜索
2、返回结构化结果（包含标题、URL和内容摘要）
3、自动缓存近期搜索结果
4、完善的速率限制和错误处理机制
5、支持实时网页抓取
6、提供多种专用搜索工具：
- 学术论文搜索
- Twitter/X 平台搜索
- 企业调研
- 竞争对手分析
- LinkedIn 搜索
二、安装准备
系统要求
1、Node.js v18 或更高版本
2、已安装 Claude Desktop 客户端
3、有效的 Exa API 密钥
4、Git 版本控制工具
验证 Node.js 版本：
node --version # 应显示 v18.0.0 或更高版本三、安装指南
1、通过 NPM 安装
npm install -g exa-mcp-server
2、使用 Smithery 自动安装
npx -y @smithery/cli install exa --client claude
3、手动安装
1、克隆代码库：
git clone https://github.com/exa-labs/exa-mcp-server.git
cd exa-mcp-server
2、安装依赖：
npm install
3、构建项目：
npm run build
4、创建全局链接：
npm link
四、配置说明
1、配置 Claude Desktop
在 Claude Desktop 应用中启用开发者模式后，通过设置 → 开发者选项 → 编辑配置 打开 claude_desktop_config.json 文件
macOS 用户：
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows 用户：
code %APPDATA%\Claude\claude_desktop_config.json
2、添加 Exa 服务配置
{"mcpServers": {"exa": {"command": "npx", "args": ["/path/to/exa-mcp-server/build/index.js"], "env": {"EXA_API_KEY": "your-api-key-here"}}}
}
注：将 your-api-key-here 替换为从 https://dashboard.exa.ai/api-keys 获取的实际 API 密钥
3、工具选择配置
通过 --tools 参数指定启用的搜索工具：
{"mcpServers": {"exa": {"command": "npx", "args": ["/path/to/exa-mcp-server/build/index.js", "--tools=web_search_exa,research_paper_search,twitter_search"], "env": {"EXA_API_KEY": "your-api-key-here"}}}
}
4、重启 Claude Desktop
1、完全退出应用（不仅是关闭窗口）
2、重新启动
3、检查界面是否显示 🔌 连接图标
五、使用方式
1、通过 NPX 直接运行
# 启用所有工具
npx exa-mcp-server# 启用指定工具
npx exa-mcp-server --tools=web_search_exa# 查看可用工具列表
npx exa-mcp-server --list-tools
2、示例查询指令
查询量子计算领域的最新进展
查找并分析关于气候变化解决方案的最新研究论文
搜索 @elonmusk 关于 SpaceX 的推文
调研 exa.ai 公司的定价和功能信息
从指定URL提取内容：https://arxiv.org/pdf/1706.03762
六、测试与调试
使用 MCP Inspector 测试
npx @modelcontextprotocol/inspector node ./build/index.js
该工具提供交互式界面，可用于：
1、测试服务功能
2、执行搜索查询
3、查看缓存结果
七、故障排除
常见问题解决方案
1、服务未找到
- 检查 npm link 是否正确设置
- 验证 Claude Desktop 配置语法
2、API 密钥问题
- 确认密钥有效性
- 检查配置中是否包含多余空格或引号
3、连接问题
查看日志文件：
# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log# Windows
type "%APPDATA%\Claude\logs\mcp*.log"
致谢
- Exa AI 提供的强大搜索 API
- Model Context Protocol 制定的规范标准
- Anthropic 开发的 Claude Desktop 客户端
伊织 xAI 2025-04-28（一）