Exa MCP Server

by MrunmayS
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Exa MCP 服务器

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

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

MCP 是什么?🤔

模型上下文协议 (MCP) 是一个允许 AI 应用(例如 Claude Desktop)连接到外部工具和数据源的系统。它为 AI 助手提供了一种清晰、安全的方式,使其能够使用本地服务和 API,同时保持用户的控制权。

这个服务器是做什么的?🚀

Exa MCP 服务器:

  • 使 AI 助手能够使用 Exa 强大的搜索 API 执行网络搜索
  • 提供结构化的搜索结果,包括标题、URL 和内容片段
  • 优雅地处理速率限制和错误情况

先决条件📋

在开始之前,请确保您已:

您可以通过运行以下命令来验证您的 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
  1. 安装依赖项:
npm install --save axios dotenv
  1. 构建项目:
npm run build
  1. 创建全局链接(这使得服务器可以从任何地方执行):
npm link

配置⚙️

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

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

打开 Claude 桌面应用程序并从左上角的菜单栏启用开发者模式。

启用后,打开“设置”(也可以从左上角的菜单栏中打开),然后导航到“开发者选项”,在那里你会找到“编辑配置”按钮。点击它将打开 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.

服务器将:

  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 文档

致谢🙏

ID: yczut74gks