🚀 使用 Exa MCP 服务器 🔍

Exa MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，它能让 AI 助手（如Claude）使用 Exa 强大的网络搜索 API，使 AI 模型能以安全且受控的方式获取实时网络信息。

演示视频 loom.com

🚀 快速开始

什么是 MCP？ 🤔

Model Context Protocol (MCP) 是一个系统，它允许 AI 应用（如Claude Desktop）连接到外部工具和服务。它提供了一种清晰且安全的方式，让 AI 助手能与本地服务和 API 进行交互，同时用户可保持控制。

该服务器的功能是什么？ 🚀

Exa MCP 服务器具备以下功能：

• 允许 AI 助手使用 Exa 的强大搜索 API 执行网络搜索。
• 提供结构化的搜索结果，包括标题、URL 和内容摘录。
• 缓存最近的搜索以便参考。
• 处理速率限制和错误情况。
• 支持实时网络爬取以获取最新内容。

📦 安装指南

先决条件 📋

在开始之前，请确保你有：

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

安装步骤

1. 克隆此仓库：

   git clone https://github.com/yourusername/exa-mcp-server.git
   cd exa-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 配置环境变量：

   • 创建一个 .env 文件并添加以下内容：

     EXA_API_KEY=你的Exa API密钥
     

4. 启动服务器：

   npm start
   

💻 使用示例

基础用法

服务器启动后，Claude Desktop 将能够通过 MCP 协议与之通信。你可以在 Claude 中使用以下命令进行搜索：

{
  "command": "search",
  "query": "你的搜索词"
}

服务器将处理请求并返回结构化的搜索结果。

✨ 主要特性

• 简化的网络搜索工具：允许 Claude 使用查询参数直接进行网络搜索。
• 可自定义的搜索参数：控制结果数量和实时爬取策略。
• 自动实时爬取：根据指定策略使用实时爬取。
• 预设最佳参数：使用默认值以获得最佳效果。
• 搜索缓存：保存最近的搜索以便参考。
• 错误处理：优雅地处理 API 错误和速率限制。
• 类型安全：完整的 TypeScript 实现，带有 Zod 验证。
• MCP 合规性：完全实现最新的 MCP 协议规范。

🔍 使用 MCP 检查器进行测试

你可以使用 MCP 检查器直接测试服务器：

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

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

🔧 技术细节

故障排除

常见问题

1. 服务器未找到

   • 确认 npm 链接已正确设置。
   • 检查 Claude Desktop 配置语法是否正确。
   • 确保 Node.js 已正确安装。

2. API 密钥问题

   • 确认你的 EXA_API_KEY 有效。
   • 检查在 Claude Desktop 中 API 密钥是否设置正确。
   • 确保 API 密钥没有空格或引号。

3. 连接问题

   • 完全重启 Claude Desktop。

   • 检查 Claude Desktop 日志：

     # macOS
     tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
     
     # Windows
     type "%APPDATA%\Claude\logs\mcp*.log"
     

获取帮助

如果你遇到问题，请查阅 MCP 文档 或访问 GitHub 讨论区寻求社区支持。

🙏 致谢

• Exa AI 提供强大的搜索 API。
• Model Context Protocol 为 MCP 规范。
• Anthropic 提供 Claude Desktop。