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. 可用工具 & 工具选择

Exa MCP 服务器包括以下工具：

• web_search: 执行实时网络搜索，具有优化的结果和内容提取。
• research_paper_search: 专门搜索学术论文和研究内容。
• twitter_search: 专门的 Twitter/X.com 搜索，可以查找推文、个人资料和对话。

您可以通过将 --tools 参数添加到您的 Claude Desktop 配置中来选择要启用的工具：

指定要启用的工具：

{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": [
        "/path/to/exa-mcp-server/build/index.js",
        "--tools=twitter_search"
      ],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

要启用多个工具，请使用逗号分隔的列表：

{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": [
        "/path/to/exa-mcp-server/build/index.js",
        "--tools=web_search,research_paper_search,twitter_search"
      ],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

如果您未指定任何工具，则将使用默认启用的所有工具。

4. 重启 Claude Desktop

为了使更改生效：

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

通过 NPX 使用

如果您更喜欢直接运行服务器，可以使用 npx：

# 默认启用所有工具运行
npx exa-mcp-server

# 仅启用特定工具
npx exa-mcp-server --tools=web_search

# 启用多个工具
npx exa-mcp-server --tools=web_search,research_paper_search

# 列出所有可用工具
npx exa-mcp-server --list-tools

用法 🎯

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

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

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

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

在 Twitter 上搜索 @elonmusk 关于 SpaceX 的帖子。

查找 @samaltman 在过去一周发布的关于 AI 安全的推文。

服务器将：

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

使用 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"
   

致谢 🙏

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