Exa

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  # Should show v18.0.0 or higher

安装 🛠️

使用 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 应用，并从左上角的菜单栏启用 Developer Mode。

启用后，打开 Settings（也在左上角的菜单栏中），然后前往 Developer Option，你会看到 Edit Config 按钮。点击该按钮即可打开 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 进行网页搜索。以下是一些提示词示例：

Can you search for recent developments in quantum computing?

Search for and summarize the latest news about artificial intelligence startups in new york.

Find and analyze recent research papers about climate change solutions.

Search for today's breaking news about tech.

Search for the top 10 AI research papers from 2023, and only use live crawling as a fallback.

Search for electric vehicles and return 3 results, always using live crawling.

此服务将：

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

功能 ✨

• 简化的网页搜索工具：只需提供一个查询参数，即可让 Claude 搜索网页
• 可自定义的搜索参数：控制结果数量和实时抓取策略
• 自动实时抓取：根据指定策略进行实时抓取
• 预设的最佳参数：为结果数量和字符数限制采用最佳默认值
• 搜索缓存：将近期搜索保存为资源，以供参考
• 错误处理：妥善处理 API 错误和速率限制
• 类型安全：使用 Zod 验证的完整 TypeScript 实现
• 符合 MCP 规范：完整实现最新的 MCP 协议规范

使用 MCP Inspector 进行测试 🔍

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

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

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

故障排除 🔧

常见问题

1. 未找到服务

   • 确认 npm link 设置正确
   • 检查 Claude Desktop 配置语法
   • 确保 Node.js 已正确安装

2. API 密钥问题

   • 确认 EXA_API_KEY 有效
   • 检查 Claude Desktop 配置中是否正确设置了 EXA_API_KEY
   • 确认 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