基本能力
产品定位
Exa MCP Server 是一个为 AI 助手提供网络搜索能力的中间件服务器,通过 Exa AI Search API 实现安全、高效的网络信息获取。
核心功能
- 通过 Exa API 进行网络搜索
- 提供结构化的搜索结果(标题、URL、内容摘要)
- 缓存最近的搜索记录
- 优雅处理速率限制和错误情况
- 支持实时网络爬取
- 完全兼容 MCP 协议规范
适用场景
- AI 助手需要获取实时网络信息
- 开发者需要为 AI 应用集成网络搜索功能
- 需要结构化搜索结果的场景
- 需要缓存搜索记录以提高效率的场景
工具列表
- MCP Inspector:用于测试服务器功能,执行搜索查询并查看缓存结果
常见问题解答
- 服务器未找到
- 检查 npm link 是否正确设置
- 验证 Claude Desktop 配置语法
-
确保 Node.js 已正确安装
-
API 密钥问题
- 确认 EXA_API_KEY 有效
- 检查 Claude Desktop 配置中的 API 密钥设置
-
确保 API 密钥周围没有空格或引号
-
连接问题
- 完全重启 Claude Desktop
- 检查 Claude Desktop 日志
使用教程
使用依赖
- Node.js (v18 或更高版本)
- Claude Desktop 已安装
- Exa API 密钥
- Git
验证 Node.js 安装:
bash
node --version # 应显示 v18.0.0 或更高版本
安装教程
NPM 安装
bash
npm install -g exa-mcp-server
使用 Smithery 安装
bash
npx -y @smithery/cli install exa --client claude
手动安装
-
克隆仓库:
bash
git clone https://github.com/exa-labs/exa-mcp-server.git
cd exa-mcp-server -
安装依赖:
bash
npm install -
构建项目:
bash
npm run build -
创建全局链接:
bash
npm link
调试方式
使用 MCP Inspector 测试服务器:
bash
npx @modelcontextprotocol/inspector node ./build/index.js
查看 Claude Desktop 日志:
```bash
macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
Windows
type "%APPDATA%\Claude\logs\mcp*.log"
```