Exa

搜索官方认证远程 TypeScript

🚀 使用 Exa MCP 服务器 🔍

Exa MCP 服务器是一个 Model Context Protocol (MCP) 服务器，它能让 AI 助手（如Claude）使用 Exa 强大的网络搜索 API，使 AI 模型可以安全且受控地获取实时网络信息。

演示视频 loom.com

🚀 快速开始

什么是 MCP？ 🤔

Model Context Protocol (MCP) 是一个系统，允许 AI 应用（如Claude Desktop）连接到外部工具和服务。它提供了一种清晰且安全的方式来让 AI 助手与本地服务和 API 进行交互，同时让用户保持控制。

该服务器的功能是什么？ 🚀

Exa MCP 服务器具备以下功能：

允许 AI 助手使用 Exa 的强大搜索 API 执行网络搜索。
提供结构化的搜索结果，包括标题、URL 和内容摘录。
缓存最近的搜索以便参考。
处理速率限制和错误情况。
支持实时网络爬取以获取最新内容。

先决条件 📋

在开始之前，请确保你有：

Node.js (v18 或更高版本)
安装了 Claude Desktop
一个 Exa API 密钥
npm 已安装

安装步骤 📦

克隆此仓库：

git clone https://github.com/yourusername/exa-mcp-server.git
cd exa-mcp-server

安装依赖项：
```
npm install
```
配置环境变量：
- 创建一个 .env 文件并添加以下内容：
```
EXA_API_KEY=你的Exa API密钥
```
启动服务器：
```
npm start
```

使用说明 💡

服务器启动后，Claude Desktop 将能够通过 MCP 协议与之通信。你可以在 Claude 中使用以下命令进行搜索：

{
"command": "search",
"query": "你的搜索词"
}

服务器将处理请求并返回结构化的搜索结果。

✨ 主要特性

简化的网络搜索工具：允许 Claude 使用查询参数直接进行网络搜索。
可自定义的搜索参数：控制结果数量和实时爬取策略。
自动实时爬取：根据指定策略使用实时爬取。
预设最佳参数：使用默认值以获得最佳效果。
搜索缓存：保存最近的搜索以便参考。
错误处理：优雅地处理 API 错误和速率限制。
类型安全：完整的 TypeScript 实现，带有 Zod 验证。
MCP 合规性：完全实现最新的 MCP 协议规范。

💻 使用示例

基础用法

在 Claude 中使用以下命令进行搜索：

{
"command": "search",
"query": "你的搜索词"
}

高级用法

可通过配置搜索参数来控制结果数量和实时爬取策略等，例如在请求中添加自定义参数。

🔍 使用 MCP 检查器进行测试

你可以使用 MCP 检查器直接测试服务器：

npx @modelcontextprotocol/inspector node ./build/index.js

这将打开一个交互式界面，让你可以探索服务器的功能、执行搜索查询并查看缓存的搜索结果。

🔧 技术细节

故障排除

常见问题

服务器未找到
- 确认 npm 链接已正确设置。
- 检查 Claude Desktop 配置语法是否正确。
- 确保 Node.js 已正确安装。
API 密钥问题
- 确认你的 EXA_API_KEY 有效。
- 检查在 Claude Desktop 中 API 密钥是否设置正确。
- 确保 API 密钥没有空格或引号。

连接问题

完全重启 Claude Desktop。

检查 Claude Desktop 日志：

# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

# Windows
type "%APPDATA%\Claude\logs\mcp*.log"

获取帮助

如果你遇到问题，请查阅 MCP 文档或访问 GitHub 讨论区寻求社区支持。

📄 许可证

文档中未提及相关许可证信息。

🙏 致谢

Exa AI 提供强大的搜索 API。
Model Context Protocol 为 MCP 规范。
Anthropic 提供 Claude Desktop。

0 条评论
分类：搜索

Exa