Exa MCP Server 使用说明

项目简介

Exa MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它利用 Exa API 提供强大的 AI 代码搜索功能。此服务器旨在作为 LLM 应用的后端，通过标准化的 MCP 接口，使 LLM 能够便捷地进行代码搜索并获取相关信息，从而增强 LLM 在代码理解和生成方面的能力。

主要功能点

AI 驱动的代码搜索: 使用自然语言查询即可进行代码搜索，背后由 Exa API 提供支持。
资源管理: 将搜索结果以资源的形式托管，方便 LLM 客户端按需访问和利用。
工具注册: 提供 'search' 工具，允许 LLM 客户端调用以执行代码搜索操作。
灵活配置: 支持配置搜索结果数量，并以 JSON 格式返回结构化数据。

安装步骤

克隆仓库

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

安装依赖
```
npm install
```
构建项目
```
npm run build
```

服务器配置

要将 Exa MCP Server 集成到 MCP 客户端（例如 Cline），您需要在客户端的 MCP 服务器配置中添加以下信息。请务必将 'your-api-key-here' 替换为您的 Exa API 密钥，并将 '/path/to/exa-server' 替换为仓库在您本地的实际路径。

{
  "mcpServers": {
    "exa": {
      "command": "node",
      "args": ["/path/to/exa-server/build/index.js"],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

配置参数说明:

'server name': 'exa' (服务器名称，您可以自定义，用于在客户端中标识此服务器)
'command': 'node' (启动服务器的命令，这里使用 Node.js 运行)
'args': '["/path/to/exa-server/build/index.js"]' (命令参数，指向构建后的服务器入口文件。请注意替换 '/path/to/exa-server' 为您克隆仓库的实际路径)
'env': '{"EXA_API_KEY": "your-api-key-here"}' (环境变量配置，'EXA_API_KEY' 用于 Exa API 的身份验证。 请务必替换 'your-api-key-here' 为您的真实 Exa API 密钥)

基本使用方法

配置并启动 Exa MCP Server 后，您的 LLM 客户端可以通过以下方式与其交互：

使用 'search' 工具进行代码搜索: 客户端可以调用名为 'search' 的工具，并提供 JSON 格式的输入参数，例如：
```
{
  "query": "查找关于文件上传的代码示例",
  "numResults": 5
}
```
- 'query': 要搜索的自然语言查询。
- 'numResults' (可选): 指定返回的搜索结果数量，默认为 10。
访问资源获取搜索结果: 客户端可以通过以下 URI 访问搜索结果资源：
- 'exa://search/{query}': 获取特定查询 '{query}' 的搜索结果。将 '{query}' 替换为您想要查询的关键词（需要进行 URL 编码）。
- 'exa://last-search/result': 获取最近一次搜索的搜索结果。

请参考 MCP 客户端的文档，了解如何在您的客户端中配置和使用 MCP 服务器以及如何调用工具和访问资源。

关键词