Exa MCP Server

MIT License
1,858
  • Apple

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
  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.
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. 缓存搜索以供将来参考

特色✨

  • 简化的 Web 搜索工具:使 Claude 仅使用查询参数即可搜索 Web
  • 可定制的搜索参数:控制结果数量和实时抓取策略
  • 自动实时抓取:根据指定策略使用实时抓取
  • 预设最佳参数:使用结果计数和字符限制的最佳默认值
  • 搜索缓存:将最近的搜索保存为参考资源
  • 错误处理:优雅地处理 API 错误和速率限制
  • 类型安全:通过 Zod 验证实现完整的 TypeScript
  • MCP 合规性:全面实施最新的 MCP 协议规范

使用 MCP Inspector 进行测试

您可以使用 MCP Inspector 直接测试服务器:

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

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

故障排除

常见问题

  1. 未找到服务器
    • 验证 npm 链接是否正确设置
    • 检查 Claude Desktop 配置语法
    • 确保 Node.js 已正确安装
  2. API 密钥问题
    • 确认您的 EXA_API_KEY 有效
    • 检查 Claude Desktop 配置中的 EXA_API_KEY 是否正确设置
    • 验证 API 密钥周围没有空格或引号
  3. 连接问题
    • 完全重启Claude Desktop
    • 检查 Claude Desktop 日志:GXP18

获取帮助

如果您遇到问题,请查看MCP 文档或访问GitHub 讨论以获得社区支持。

致谢🙏

ID: pcaft49gu3