使用说明
Exa MCP服务器🔍
模型上下文协议(MCP)服务器允许像Claude这样的人工智能助手使用Exa人工智能搜索API进行网络搜索。这种设置允许AI模型以安全和可控的方式获取实时网络信息。
演示视频https://www.loom.com/share/ac676f29664e4c6cb33a2f0a63772038?sid=0e72619f-5bfc-415d-a705-63d326373f60
什么是MCP? 🤔
模型上下文协议(MCP)是一个允许人工智能应用程序(如Claude Desktop)连接到外部工具和数据源的系统。它为AI助手提供了一种清晰安全的方式来使用本地服务和API,同时让用户保持控制。
这个服务器做什么? 🚀
Exa MCP服务器:
- 使人工智能助手能够使用Exa强大的搜索API进行网络搜索
- 提供结构化搜索结果,包括标题、URL和内容片段
- 将最近的搜索缓存为参考资源
- 优雅地处理速率限制和错误情况
- 支持实时网络抓取新鲜内容
先决条件📋
在开始之前,请确保您已经:
您可以通过运行以下命令来验证您的Node.js安装:
node --version # Should show v18.0.0 or higher
安装🛠️
NPM安装
npm install -g exa-mcp-server
使用Smithery
通过以下方式自动安装Claude Desktop的Exa MCP服务器 史密瑟里:
npx -y @smithery/cli install exa --client claude
手动安装
- 克隆存储库:
git clone https://github.com/exa-labs/exa-mcp-server.git
cd exa-mcp-server
- 安装依赖项:
npm install
- 构建项目:
npm run build
- 创建全局链接(这使得服务器可以从任何地方执行):
npm link
配置⚙️
1.配置Claude Desktop以识别Exa MCP服务器
您可以在claude desktop应用程序的设置中找到claude_desktop_config.json:
打开Claude Desktop应用程序,从左上角菜单栏启用开发人员模式。
启用后,打开“设置”(也是从左上角菜单栏),导航到“开发人员选项”,您将在其中找到“编辑配置”按钮。点击它将打开claude_desktop_config.json文件,允许您进行必要的编辑。
或者(如果你想从终端打开claude_desktop_config.json)
对于macOS:
- 打开您的Claude Desktop配置:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
对于Windows:
- 打开您的Claude Desktop配置:
code %APPDATA%\Claude\claude_desktop_config.json
2.添加Exa服务器配置:
{
"mcpServers": {
"exa": {
"command": "npx",
"args": ["/path/to/exa-mcp-server/build/index.js"],
"env": {
"EXA_API_KEY": "your-api-key-here"
}
}
}
}
替换 your-api-key-here 使用来自的Exa API密钥 dashboard.exa.ai/api-keys.
3.重新启动克劳德桌面
要使更改生效,请执行以下操作:
- 完全退出Claude Desktop(不仅仅是关闭窗口)
- 重新启动克劳德桌面
- 寻找🔌 用于验证Exa服务器是否已连接的图标
用法🎯
配置后,您可以要求Claude执行网络搜索。以下是一些示例提示:
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.
Search for today's breaking news about tech.
Search for the top 10 AI research papers from 2023, and only use live crawling as a fallback.
Search for electric vehicles and return 3 results, always using live crawling.
服务器将:
- 处理搜索请求
- 使用最佳设置(包括实时爬网)查询Exa API
- 将格式化结果返回给Claude
- 缓存搜索以供将来参考
特性✨
- 简化的网络搜索工具:允许Claude仅使用查询参数搜索网络
- 可自定义的搜索参数:控制结果数量和实时爬行策略
- 自动实时爬行:使用基于指定策略的实时爬行
- 预设最佳参数:对结果计数和字符限制使用最佳默认值
- 搜索缓存:将最近的搜索保存为资源以供参考
- 错误处理:优雅地处理API错误和速率限制
- 类型安全:带Zod验证的完整TypeScript实现
- MCP合规性:完全实施最新的MCP协议规范
MCP检验员测试🔍
您可以直接使用MCP检查器测试服务器:
npx @modelcontextprotocol/inspector node ./build/index.js
这将打开一个交互式界面,您可以在其中探索服务器的功能、执行搜索查询和查看缓存的搜索结果。
故障排除🔧
常见问题
-
找不到服务器
- 验证npm链接是否设置正确
- 检查Claude Desktop配置语法
- 确保Node.js安装正确
-
API关键问题
- 确认您的EXA_API_KEY有效
- 检查在Claude Desktop配置中是否正确设置了EXA_API_KEY
- 验证API键周围没有空格或引号
-
连接问题
- 完全重新启动克劳德桌面
- 检查克劳德桌面日志:
# macOS tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # Windows type "%APPDATA%\Claude\logs\mcp*.log"
获取帮助
如果您遇到问题,请查看 MCP文件 或访问 GitHub讨论 社区支持。