Exa MCP 服务器 🔍

一个 Model Context Protocol (MCP) 服务器允许像 Claude 这样的 AI 助手使用 Exa 的强大网络搜索 API。这种设置可以让 AI 模型以安全且受控的方式获取实时网络信息。

演示视频

https://www.loom.com/share/ac676f29664e4c6cb33a2f0a63772038?sid=0e72619f-5bfc-415d-a705-63d326373f60

什么是 MCP？ 🤔

Model Context Protocol (MCP) 是一个系统，允许 AI 应用（如 Claude Desktop）连接到外部工具和服务。通过 MCP，AI 助手可以更高效地与外部数据源交互。

Exa MCP 服务器的功能 🚀

• 网络搜索工具：让 Claude 使用自然语言查询搜索网络
• 错误处理：优雅处理 API 错误和速率限制
• 类型安全：完整的 TypeScript 实现，带全面的类型检查

先决条件 🔧

• Node.js: 确保安装了最新版本的 Node.js 和 npm
• Claude Desktop: 需要安装并运行 Claude Desktop
• Exa API Key: 注册 Exa 账户以获取有效的 API 密钥

安装指南 📋

1. 使用 NPM 安装

npm install -g exa-mcp-server

2. 使用 Smithery 安装

smithery add exa

3. 手动安装

1. 下载并解压源代码包
2. 进入项目目录运行：

   npm install
   

配置指南 🎯

修改 Claude 配置文件

找到或创建 claude_desktop_config.json 文件，添加以下内容：

{
  "mcp": {
    "servers": [
      {
        "name": "exa_mcp",
        "type": "custom",
        "uri": "localhost:1234",
        "api_key": "your_exa_api_key_here"
      }
    ]
  }
}

使用指南 💻

示例查询

- 查询科技新闻：`What's the latest news about AI?`
- 搜索技术文档：`Find me the documentation for Node.js v18`

### 工作流程
1. **处理搜索请求**
2. **调用 Exa API**
3. **返回格式化结果给 Claude**
4. **缓存搜索结果**

## 功能亮点 ✨
- **网络搜索**：支持自然语言查询
- **错误恢复**：智能重试机制
- **速率限制**：自动处理 API 限流

## 故障排除 🔧

### 常见问题

1. **服务器未找到**
   - 确保 npm 链接正确设置
   - 检查 Claude 配置文件语法
   - 确认 Node.js 安装无误

2. **API 密钥问题**
   - 确认 API 密钥有效
   - 检查密钥是否正确配置
   - 确保密钥无空格或引号

3. **连接问题**
   - 重启 Claude Desktop 完整
   - 查看日志：
     ```
     # macOS
     tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
     ```

### 获取帮助
查阅 [MCP 文档](https://modelcontextprotocol.io)

---

## 致谢 🙏

感谢以下支持：
- **Exa AI**：提供强大的搜索 API
- **Model Context Protocol**：定义 MCP 标准
- **Anthropic**：开发 Claude Desktop