项目简介

exa-mcp-server 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在为 AI 助手提供网络搜索功能。通过集成 Exa AI 搜索 API,该服务器允许 AI 助手安全、可控地访问和利用实时的网络信息,从而增强其上下文理解和信息检索能力。

主要功能点

  • 网络搜索工具: 允许 AI 助手通过自然语言查询执行网络搜索。
  • 结构化搜索结果: 返回包含标题、URL 和内容片段的结构化搜索结果。
  • 错误处理: 优雅地处理 API 错误和速率限制,确保服务稳定性。
  • 搜索历史记录: 支持缓存最近的搜索记录,并作为资源提供给客户端访问。

安装步骤

前提条件

安装方法

  1. 使用 npm 全局安装 (推荐)

    npm install -g exa-mcp-server
  2. 手动安装

    git clone https://github.com/MCP-Mirror/exa-labs_exa-mcp-server.git
    cd exa-mcp-server
    npm install
    npm run build
    npm link

服务器配置

要将 exa-mcp-server 配置为 Claude Desktop 的 MCP 服务器,您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'。

1. 打开 Claude Desktop 配置文件

  • 启动 Claude Desktop 应用程序,并启用开发者模式(Developer Mode)。
  • 在菜单栏中选择 "Settings" -> "Developer Options" -> "Edit Config" 打开 'claude_desktop_config.json' 文件。
  • 或者,您可以通过终端命令打开配置文件:
    • macOS: 'code ~/Library/Application\ Support/Claude/claude_desktop_config.json'
    • Windows: 'code %APPDATA%\Claude\claude_desktop_config.json'

2. 添加 Exa 服务器配置

在 'claude_desktop_config.json' 文件中的 '"mcpServers"' 字段下添加以下配置信息。请将 '"your-api-key-here"' 替换为您在 dashboard.exa.ai/api-keys 获取的 Exa API 密钥。

{
  "mcpServers": {
    "exa": {
      "command": "npx",  // 启动命令,使用 npx 运行
      "args": ["exa-mcp-server"], // 命令参数,exa-mcp-server 是 npm link 创建的全局可执行命令
      "env": {
        "EXA_API_KEY": "your-api-key-here" // 环境变量,用于传递 Exa API 密钥
      }
    }
  }
}

3. 重启 Claude Desktop

  • 完全退出 Claude Desktop 应用程序 (确保在任务栏或 Dock 栏中也退出)。
  • 重新启动 Claude Desktop。
  • 观察 Claude Desktop 界面,如果看到 🔌 图标,则表示 Exa 服务器已成功连接。

基本使用方法

配置完成后,您可以直接在 Claude Desktop 中使用自然语言指令进行网络搜索。以下是一些示例:

搜索量子计算的最新进展
查找并总结纽约人工智能初创公司的最新消息
寻找并分析关于气候变化解决方案的最新研究论文

Claude 会将搜索请求发送到 exa-mcp-server,服务器会调用 Exa API 执行搜索,并将结果返回给 Claude。

信息

分类

网页与API