Exa MCP Server 🔍

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

安装 🛠️

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 执行网络搜索。以下是一些示例提示词：

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.

此服务将：

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

• 感谢 Model Context Protocol 制定 MCP 规范

• 感谢 Anthropic 提供 Claude Desktop