项目简介
exa-mcp-server 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在为 AI 助手提供网络搜索功能。通过集成 Exa AI 搜索 API,该服务器允许 AI 助手安全、可控地访问和利用实时的网络信息,从而增强其上下文理解和信息检索能力。
主要功能点
- 网络搜索工具: 允许 AI 助手通过自然语言查询执行网络搜索。
- 结构化搜索结果: 返回包含标题、URL 和内容片段的结构化搜索结果。
- 错误处理: 优雅地处理 API 错误和速率限制,确保服务稳定性。
- 搜索历史记录: 支持缓存最近的搜索记录,并作为资源提供给客户端访问。
安装步骤
前提条件
- 已安装 Node.js (v18 或更高版本)
- 已安装 Claude Desktop
- 已拥有 Exa API key
- 已安装 Git
安装方法
-
使用 npm 全局安装 (推荐)
npm install -g exa-mcp-server -
手动安装
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