项目简介
Exa MCP服务器是一个基于Model Context Protocol (MCP) 的应用后端,它使得AI助手能够通过Exa AI强大的搜索API进行网络搜索。该服务器充当AI助手和Exa搜索API之间的桥梁,安全地提供实时的网络信息,扩展了AI助手的知识获取能力。
主要功能点
- 网页搜索工具: 允许AI助手使用自然语言查询进行网页搜索,获取最新的网络信息。
- 结构化搜索结果: 返回包含标题、URL和内容片段的结构化搜索结果,方便AI助手理解和利用。
- 错误处理: 能够优雅地处理API错误和速率限制,保证服务的稳定性。
- 搜索历史记录: 缓存最近的搜索结果,并作为资源提供给AI助手访问,方便回顾和参考。
安装步骤
- 安装 Node.js 和 npm: 确保你的电脑上已安装 Node.js (v18 或更高版本) 和 npm 包管理器。
- 全局安装 Exa MCP 服务器: 打开终端,运行命令 'npm install -g exa-mcp-server',将 Exa MCP 服务器安装到全局环境。
- 配置 Claude Desktop: 按照以下“服务器配置”步骤,配置你的 Claude Desktop 应用,使其能够连接到 Exa MCP 服务器。
服务器配置
MCP服务器需要配置到支持MCP协议的客户端中才能使用,例如Claude Desktop。配置过程主要是在客户端的配置文件中添加MCP服务器的启动信息。以下是在 Claude Desktop 中配置 Exa MCP 服务器的步骤:
-
打开 Claude Desktop 配置文件:
- 启动 Claude Desktop 应用,并启用开发者模式(通常在菜单栏的某个位置,例如 "Developer" 或 "Debug")。
- 找到并打开配置文件 'claude_desktop_config.json'。具体位置可能在应用的设置或开发者选项中,或者根据 README 中的指引查找。
-
添加 Exa MCP 服务器配置:
- 在 'claude_desktop_config.json' 文件的 'mcpServers' 字段中,添加一个名为 'exa' 的服务器配置。
- 将以下 JSON 代码添加到 'mcpServers' 中,并将 'your-api-key-here' 替换为你从 Exa AI 官网申请的 API 密钥。
{ "mcpServers": { "exa": { "command": "npx", "args": ["exa-mcp-server"], "env": { "EXA_API_KEY": "your-api-key-here" } } } }配置参数说明:
- 'server name': 'exa' - 服务器名称,用于在客户端中标识和引用。
- 'command': 'npx' - 启动服务器的命令。'npx' 允许运行全局安装的 npm 包。
- 'args': '["exa-mcp-server"]' - 传递给 'npx' 命令的参数。这里指定要运行的包名称为 'exa-mcp-server'。
- 'env': '{ "EXA_API_KEY": "your-api-key-here" }' - 环境变量配置。'EXA_API_KEY' 用于传递 Exa API 密钥给服务器程序。请务必替换 'your-api-key-here' 为你自己的 API 密钥。
-
重启 Claude Desktop: 完成配置后,完全退出并重新启动 Claude Desktop 应用,配置才会生效。
基本使用方法
配置完成后,你就可以在 Claude Desktop 中通过自然语言指令来使用网页搜索功能了。例如,你可以尝试以下指令:
- 'Can you search for recent developments in quantum computing?' (你能搜索量子计算的最新进展吗?)
- 'Search for and summarize the latest news about artificial intelligence startups in new york.' (搜索并总结纽约人工智能创业公司的最新消息。)
- 'Find and analyze recent research papers about climate change solutions.' (查找并分析关于气候变化解决方案的最新研究论文。)
当 Claude 接收到包含搜索意图的指令时,Exa MCP 服务器就会被调用,执行网页搜索并将结果返回给 Claude,从而实现联网搜索的功能。
信息
分类
网页与API