Exa MCP 服务器 🔍

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

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

什么是 MCP？ 🤔

模型上下文协议 (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 或更高版本

安装 🛠️

1. 克隆存储库：

git clone https://github.com/exa-labs/exa-mcp-server.git
cd exa-mcp-server

2. 安装依赖项：

npm install --save axios dotenv

3. 构建项目：

npm run build

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

npm link

配置 ⚙️

1. Claude Desktop 配置

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

您也可以在 Claude Desktop 应用程序的设置中找到 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 密钥。

2. 重启 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 密钥有效

   • 检查 API 密钥是否在 Claude Desktop 配置中正确设置

   • 验证 API 密钥周围没有空格或引号

3. 连接问题

   • 完全重启 Claude Desktop

   • 检查 Claude Desktop 日志：

     # macOS
     tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
     

获取帮助

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

致谢 🙏

• Exa AI 感谢他们强大的搜索 API

• 模型上下文协议 感谢 MCP 规范

• Anthropic 感谢 Claude Desktop