Exa MCP Server

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. 克隆存储库：

2. 安装依赖项：

3. 构建项目：

4. 创建全局链接（这使得服务器可以从任何地方执行）：

配置⚙️

1. 配置 Claude Desktop 以识别 Exa MCP 服务器

您可以在 Claude Desktop 应用程序的设置中找到 claude_desktop_config.json：

打开 Claude 桌面应用程序并从左上角的菜单栏启用开发者模式。

启用后，打开“设置”（也可以从左上角的菜单栏中打开），然后导航到“开发者选项”，在那里你会找到“编辑配置”按钮。点击它将打开 claude_desktop_config.json 文件，允许你进行必要的编辑。

或者（如果您想从终端打开 claude_desktop_config.json）

对于 macOS：

1. 打开您的 Claude Desktop 配置：

对于 Windows：

1. 打开您的 Claude Desktop 配置：

2.添加Exa服务器配置：

将your-api-key-here替换为来自dashboard.exa.ai/api-keys的实际 Exa API 密钥。

3. 重启 Claude Desktop

要使更改生效：

1. 完全退出 Claude Desktop（不只是关闭窗口）
2. 重新启动 Claude Desktop
3. 查找🔌图标以验证 Exa 服务器是否已连接

用法🎯

配置完成后，你可以让 Claude 执行网页搜索。以下是一些示例提示：

服务器将：

1. 处理搜索请求
2. 查询 Exa API
3. 将格式化的结果返回给 Claude
4. 缓存搜索以供将来参考

特色✨

• 网络搜索工具：使 Claude 能够使用自然语言查询搜索网络
• 错误处理：优雅地处理 API 错误和速率限制
• 类型安全：完整的 TypeScript 实现，并带有适当的类型检查

故障排除

常见问题

1. 未找到服务器
   • 验证 npm 链接是否正确设置
   • 检查 Claude Desktop 配置语法
   • 确保 Node.js 已正确安装
2. API 密钥问题
   • 确认您的 Exa API 密钥有效
   • 检查 Claude Desktop 配置中的 API 密钥是否正确设置
   • 验证 API 密钥周围没有空格或引号
3. 连接问题
   • 完全重启Claude Desktop
   • 检查 Claude Desktop 日志：
     # macOS tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

获取帮助

如果您遇到问题，请查看MCP 文档

致谢🙏

• Exa AI提供强大的搜索 API
• MCP 规范的模型上下文协议
• 克劳德桌面版的Anthropic