基本能力
产品定位
Exa MCP Server 是一个为 AI 助手提供网页搜索能力的中间件,通过 Exa AI Search API 实现安全、高效的网络信息检索。
核心功能
- 网页搜索功能:通过 Exa API 执行网页搜索,返回标题、URL 和内容摘要。
- 搜索缓存:缓存最近的搜索结果以供后续参考。
- 实时爬取:支持实时网页爬取以获取最新内容。
- 错误处理:优雅处理 API 错误和速率限制。
- 类型安全:使用 TypeScript 和 Zod 验证实现类型安全。
- MCP 兼容:完全遵循最新的 MCP 协议规范。
适用场景
- AI 助手需要实时网络信息时(如新闻、研究论文等)。
- 需要结构化搜索结果的场景。
- 需要缓存搜索历史以提高效率的场景。
工具列表
- MCP Inspector:用于测试服务器功能,支持交互式查询和查看缓存结果。
常见问题解答
- 服务器未找到:检查 npm link 是否正确设置,确认 Node.js 安装无误。
- API 密钥问题:确认 EXA_API_KEY 有效且配置正确。
- 连接问题:重启 Claude Desktop 并检查日志文件。
使用教程
使用依赖
- Node.js (v18 或更高版本)
- Claude Desktop
- Exa API 密钥
- Git
验证 Node.js 安装:
bash
node --version
安装教程
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