Exa MCP 服务器 🔍

Model Context Protocol (MCP) 服务器允许像 Claude 这样的 AI 助手使用 Exa AI Search API 进行网络搜索。这种设置允许 AI 模型以安全和受控的方式获取实时网络信息。

演示视频 https://www.loom.com/share/ac676f29664e4c6cb33a2f0a63772038?sid=0e72619f-5bfc-415d-a705-63d326373f60

什么是 MCP？ 🤔

Model Context Protocol (MCP) 是一个系统，允许像 Claude Desktop 这样的 AI 应用程序连接到外部工具和数据源。它为 AI 助手提供了一种清晰且安全的方式来使用本地服务和 API，同时保持用户控制。

这个服务器做什么？ 🚀

Exa MCP 服务器：

• 使 AI 助手能够使用 Exa 强大的搜索 API 执行网络搜索
• 提供结构化的搜索结果，包括标题、URL 和内容片段
• 缓存最近的搜索作为参考资源
• 优雅地处理速率限制和错误情况
• 支持实时网络爬取以获取最新内容

前提条件 📋

在开始之前，请确保您已具备：

• Node.js (v18 或更高版本)
• 已安装 Claude Desktop
• 一个 Exa API 密钥
• 已安装 Git

您可以通过运行以下命令来验证您的 Node.js 安装：

node --version  # 应该显示 v18.0.0 或更高版本

安装 🛠️

NPM 安装

npm install -g exa-mcp-server

使用 Smithery

要通过 Smithery 为 Claude Desktop 自动安装 Exa MCP 服务器：

npx -y @smithery/cli install exa --client claude

手动安装

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 以识别 Exa MCP 服务器

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

打开 Claude Desktop 应用程序，然后从左上角的菜单栏启用开发者模式。

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

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

对于 macOS：

1. 打开您的 Claude Desktop 配置：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

对于 Windows：

1. 打开您的 Claude Desktop 配置：

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 替换为您从 dashboard.exa.ai/api-keys 获取的实际 Exa API 密钥。

3. 重启 Claude Desktop

为了使更改生效：

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

用法 🎯

配置完成后，您可以要求 Claude 执行网络搜索。 以下是一些示例提示：

你能搜索一下量子计算的最新进展吗？

搜索并总结一下纽约人工智能创业公司的最新消息。

查找并分析有关气候变化解决方案的最新研究论文。

搜索今天关于科技的突发新闻。

搜索 2023 年排名前 10 的 AI 研究论文，并且只使用实时爬取作为后备方案。

搜索电动汽车并返回 3 个结果，始终使用实时爬取。

服务器将：

1. 处理搜索请求
2. 使用最佳设置（包括实时爬取）查询 Exa API
3. 将格式化的结果返回给 Claude
4. 缓存搜索以供将来参考

功能 ✨

• 简化的网络搜索工具：使 Claude 能够仅使用查询参数搜索网络
• 可自定义的搜索参数：控制结果数量和实时爬取策略
• 自动实时爬取：根据指定的策略使用实时爬取
• 预设的最佳参数：使用结果计数和字符限制的最佳默认值
• 搜索缓存：将最近的搜索保存为参考资源
• 错误处理：优雅地处理 API 错误和速率限制
• 类型安全：完整的 TypeScript 实现，带有 Zod 验证
• MCP 兼容性：完全实现最新的 MCP 协议规范

使用 MCP Inspector 进行测试 🔍

您可以使用 MCP Inspector 直接测试服务器：

npx @modelcontextprotocol/inspector node ./build/index.js

这将打开一个交互式界面，您可以在其中探索服务器的功能、执行搜索查询以及查看缓存的搜索结果。

故障排除 🔧

常见问题

1. 找不到服务器

   • 验证 npm 链接是否正确设置
   • 检查 Claude Desktop 配置语法
   • 确保 Node.js 已正确安装

2. API 密钥问题

   • 确认您的 EXA_API_KEY 有效
   • 检查 EXA_API_KEY 是否在 Claude Desktop 配置中正确设置
   • 验证 API 密钥周围没有空格或引号

3. 连接问题

   • 完全重启 Claude Desktop
   • 检查 Claude Desktop 日志：

   # macOS
   tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
   
   # Windows
   type "%APPDATA%\Claude\logs\mcp*.log"
   

获得帮助

如果您遇到问题，请查看 MCP 文档 或访问 GitHub 讨论 以获得社区支持。

致谢 🙏

• Exa AI 感谢他们强大的搜索 API
• Model Context Protocol 感谢 MCP 规范
• Anthropic 感谢 Claude Desktop