使用说明

项目简介

exa-mcp 是一个实现了 Model Context Protocol (MCP) 的服务器，它将 Exa Search API 封装成一个工具，供支持 MCP 协议的 LLM 客户端调用。通过该服务器，LLM 可以利用 Exa Search API 强大的搜索能力，获取网络信息，从而增强 LLM 的上下文理解和信息检索能力。

主要功能点

网页搜索工具: 提供名为 'exa_search' 的工具，LLM 可以调用该工具执行网页搜索。
灵活的搜索参数: 支持多种搜索参数，如查询关键词、结果类型、时间范围、域名限制等，满足不同的搜索需求。
标准 MCP 协议: 遵循 MCP 协议标准，易于集成到任何支持 MCP 协议的 LLM 客户端。
多种传输协议: 支持 Stdio 和 SSE 两种传输协议，可以根据需要选择合适的部署方式。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm。
获取 Exa API Key: 访问 https://dashboard.exa.ai/api-keys 注册并获取你的 Exa API Key。
运行服务器: 在终端中执行以下命令启动服务器 (首次运行会自动安装依赖):
- Stdio 服务器:
```
npx -y exa-mcp
```
- SSE 服务器:
```
npx -y exa-mcp --sse
```
- 配置 API Key: 在运行上述命令之前，需要设置环境变量 'EXA_API_KEY' 为你的 Exa API Key。例如，在 Linux/macOS 系统中可以使用 'export EXA_API_KEY=你的API密钥' 命令，在 Windows 系统中使用 'set EXA_API_KEY=你的API密钥' 命令。

服务器配置

对于 MCP 客户端，你需要配置连接到 exa-mcp 服务器的信息。以下是一个 JSON 格式的配置示例，你需要将其添加到你的 MCP 客户端的配置文件中。请务必将 '<your-api-key>' 替换为你实际的 Exa API Key。

{
  "mcpServers": {
    "exa": {
      "command": "npx", // 启动服务器的命令
      "args": ["-y", "exa-mcp"], // 传递给命令的参数，这里启动的是 Stdio 服务器
      "env": {
        "EXA_API_KEY": "<your-api-key>" // Exa API Key 环境变量，请替换为你的实际 API Key
      }
    }
  }
}

如果需要配置 SSE 服务器，可以将 'args' 修改为 '["-y", "exa-mcp", "--sse"]'。

基本使用方法

启动 exa-mcp 服务器后，在你的 MCP 客户端中配置并连接到该服务器。连接成功后，LLM 即可通过调用名为 'exa_search' 的工具来执行网页搜索。具体的调用方式和参数请参考你的 MCP 客户端的使用文档。例如，你可以指示 LLM 使用 'exa_search' 工具来搜索特定主题的信息，并将搜索结果作为上下文用于后续的对话或任务。

关键词