Exa MCP

🚀 使用 Exa MCP 服务器 🔍

Exa MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，它能让像 Claude 这样的 AI 助手借助 Exa 强大的网络搜索 API，实时获取互联网信息，且整个过程在安全可控的环境中进行。

演示视频 🔗

点击查看演示视频

🚀 快速开始

Exa MCP 服务器能让 AI 助手与外部工具进行智能交互，借助 Exa 的网络搜索 API 实时获取信息。下面为你介绍使用该服务器的详细步骤。

✨ 主要特性

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

📦 安装指南

在安装 Exa MCP 服务器之前，请确保满足以下先决条件：

1. 安装 Node.js（推荐版本为 14 或更高）。
2. 安装 Claude Desktop。
3. 获取有效的 Exa API 密钥。

方法一：使用 npm

npm install -g exa-mcp-server

方法二：使用 Smithery

smithery install exa

手动安装

1. 克隆仓库：

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

2. 安装依赖：

   npm install
   

3. 构建项目（可选）：

   npm run build
   

📚 详细文档

配置说明 ⚙️

步骤 1：配置 Claude Desktop

编辑 claudia.json 文件，添加以下内容：

{
  "mcpServers": {
    "exaMCP": {
      "type": "custom",
      "class": "ExaMCPHandler",
      "url": "http://localhost:3000"
    }
  }
}

步骤 2：设置 API 密钥

在 env 文件中添加：

EXA_API_KEY=your_api_key_here

使用方法 💻

1. 发起搜索请求：

   claudia exaMCP --query "什么是量子计算？"
   

2. 服务器处理请求：
   • 分析查询。
   • 调用 Exa API 获取结果。
   • 返回格式化后的结果。
3. 缓存机制：支持搜索结果的缓存，以提高后续查询的速度。

常见问题排查 🔧

1. 服务器未找到

• 确保 npm 链接正确配置。
• 检查 Claude Desktop 配置文件语法。
• 确认 Node.js 正确安装。

2. API 密钥问题

• 验证 Exa API 密钥的有效性。
• 确保密钥在 env 文件中正确设置。
• 检查密钥是否有空格或引号。

3. 连接问题

• 完全重启 Claude Desktop。
• 查看日志：

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

获取帮助 🤔

如果遇到问题，请查阅 MCP 文档。

致谢 🙏

• Exa AI：感谢其强大的搜索 API。
• Model Context Protocol：感谢 MCP 规范的制定者。
• Anthropic：感谢 Claude Desktop 的开发团队。

🔧 技术细节

MCP 是一个协议，允许 AI 模型与其上下文环境之间建立更智能的交互。通过 MCP，AI 可以直接调用外部工具和服务来增强其功能。Exa MCP 服务器基于此协议，实现了让 Claude 等 AI 助手利用 Exa 网络搜索 API 的功能。