Exa MCP Server 🔍

Exa MCP Server 🔍

site icon
2025.03.22 0
AI 助手网络搜索API 集成搜索工具开发效率
Exa MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,旨在为 AI 助手(如 Claude)提供通过 Exa AI Search API 进行网络搜索的能力。该服务器允许 AI 模型以安全且受控的方式获取实时网络信息,支持结构化搜索结果、缓存搜索记录、处理速率限制和错误情况,并支持实时网络爬取。
View on GitHub

Overview

基本能力

产品定位

Exa MCP Server 是一个为 AI 助手提供网络搜索能力的中间件服务器,通过 Exa AI Search API 实现安全、高效的网络信息获取。

核心功能

  • 通过 Exa API 进行网络搜索
  • 提供结构化的搜索结果(标题、URL、内容摘要)
  • 缓存最近的搜索记录
  • 优雅处理速率限制和错误情况
  • 支持实时网络爬取
  • 完全兼容 MCP 协议规范

适用场景

  • AI 助手需要获取实时网络信息
  • 开发者需要为 AI 应用集成网络搜索功能
  • 需要结构化搜索结果的场景
  • 需要缓存搜索记录以提高效率的场景

工具列表

  • MCP Inspector:用于测试服务器功能,执行搜索查询并查看缓存结果

常见问题解答

  1. 服务器未找到
  2. 检查 npm link 是否正确设置
  3. 验证 Claude Desktop 配置语法
  4. 确保 Node.js 已正确安装

  5. API 密钥问题

  6. 确认 EXA_API_KEY 有效
  7. 检查 Claude Desktop 配置中的 API 密钥设置
  8. 确保 API 密钥周围没有空格或引号

  9. 连接问题

  10. 完全重启 Claude Desktop
  11. 检查 Claude Desktop 日志

使用教程

使用依赖

  • Node.js (v18 或更高版本)
  • Claude Desktop 已安装
  • Exa API 密钥
  • Git

验证 Node.js 安装:

node --version  # 应显示 v18.0.0 或更高版本

安装教程

NPM 安装

npm install -g exa-mcp-server

使用 Smithery 安装

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

调试方式

使用 MCP Inspector 测试服务器:

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

查看 Claude Desktop 日志:

# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

# Windows
type "%APPDATA%\Claude\logs\mcp*.log"

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。