Exa MCP 服务器
模型上下文协议 (MCP) 服务器允许像 Claude 这样的 AI 助手使用 Exa AI Search API 进行网页搜索。此设置允许 AI 模型以安全可控的方式获取实时网页信息。
演示视频https://www.loom.com/share/ac676f29664e4c6cb33a2f0a63772038?sid=0e72619f-5bfc-415d-a705-63d326373f60
MCP 是什么?🤔
模型上下文协议 (MCP) 是一个允许 AI 应用(例如 Claude Desktop)连接到外部工具和数据源的系统。它为 AI 助手提供了一种清晰、安全的方式,使其能够使用本地服务和 API,同时保持用户的控制权。
这个服务器是做什么的?🚀
Exa MCP 服务器:
- 使 AI 助手能够使用 Exa 强大的搜索 API 执行网络搜索
- 提供结构化的搜索结果,包括标题、URL 和内容片段
- 将最近的搜索缓存为参考资源
- 优雅地处理速率限制和错误情况
- 支持实时网页抓取新鲜内容
先决条件📋
在开始之前,请确保您已:
- Node.js (v18 或更高版本)
- 已安装Claude Desktop
- Exa API 密钥
- Git 安装
您可以通过运行以下命令来验证您的 Node.js 安装:
安装🛠️
NPM 安装
使用 Smithery
要通过Smithery自动为 Claude Desktop 安装 Exa MCP 服务器:
手动安装
- 克隆存储库:
- 安装依赖项:
- 构建项目:
- 创建全局链接(这使得服务器可以从任何地方执行):
配置⚙️
1. 配置 Claude Desktop 以识别 Exa MCP 服务器
您可以在 Claude Desktop 应用程序的设置中找到 claude_desktop_config.json:
打开 Claude 桌面应用程序并从左上角的菜单栏启用开发者模式。
启用后,打开“设置”(也可以从左上角的菜单栏中打开),然后导航到“开发者选项”,在那里你会找到“编辑配置”按钮。点击它将打开 claude_desktop_config.json 文件,允许你进行必要的编辑。
或者(如果您想从终端打开 claude_desktop_config.json)
对于 macOS:
- 打开您的 Claude Desktop 配置:
对于 Windows:
- 打开您的 Claude Desktop 配置:
2.添加Exa服务器配置:
将your-api-key-here
替换为来自dashboard.exa.ai/api-keys的实际 Exa API 密钥。
3. 重启 Claude Desktop
要使更改生效:
- 完全退出 Claude Desktop(不只是关闭窗口)
- 重新启动 Claude Desktop
- 查找🔌图标以验证 Exa 服务器是否已连接
用法🎯
配置完成后,你可以让 Claude 执行网页搜索。以下是一些示例提示:
服务器将:
- 处理搜索请求
- 使用最佳设置查询 Exa API(包括实时抓取)
- 将格式化的结果返回给 Claude
- 缓存搜索以供将来参考
特色✨
- 简化的 Web 搜索工具:使 Claude 仅使用查询参数即可搜索 Web
- 可定制的搜索参数:控制结果数量和实时抓取策略
- 自动实时抓取:根据指定策略使用实时抓取
- 预设最佳参数:使用结果计数和字符限制的最佳默认值
- 搜索缓存:将最近的搜索保存为参考资源
- 错误处理:优雅地处理 API 错误和速率限制
- 类型安全:通过 Zod 验证实现完整的 TypeScript
- MCP 合规性:全面实施最新的 MCP 协议规范
使用 MCP Inspector 进行测试
您可以使用 MCP Inspector 直接测试服务器:
这将打开一个交互式界面,您可以在其中探索服务器的功能、执行搜索查询并查看缓存的搜索结果。
故障排除
常见问题
- 未找到服务器
- 验证 npm 链接是否正确设置
- 检查 Claude Desktop 配置语法
- 确保 Node.js 已正确安装
- API 密钥问题
- 确认您的 EXA_API_KEY 有效
- 检查 Claude Desktop 配置中的 EXA_API_KEY 是否正确设置
- 验证 API 密钥周围没有空格或引号
- 连接问题
- 完全重启Claude Desktop
- 检查 Claude Desktop 日志:GXP18
获取帮助
如果您遇到问题,请查看MCP 文档或访问GitHub 讨论以获得社区支持。
致谢🙏
This server cannot be installed
该服务器使 Claude 等 AI 助手能够使用 Exa AI Search API 执行网络搜索,以安全可控的方式提供实时网络信息。
Appeared in Searches
- A server for finding the cheapest flights for a specified date range
- Accessing a webcheck server to retrieve JSON data for website analysis
- A server for finding job opportunities on job boards
- Using a search engine to find evidence to answer a question
- A tool for tracking mentions on social media using keywords