Exa

🚀 使用 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 已安裝

安裝步驟

1. 克隆此倉庫：

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

2. 安裝依賴項：

   npm install
   

3. 配置環境變量：

   • 創建一個 .env 文件並添加以下內容：

     EXA_API_KEY=你的Exa API密鑰
     

4. 啟動服務器：

   npm start
   

💻 使用示例

基礎用法

服務器啟動後，Claude Desktop 將能夠通過 MCP 協議與之通信。你可以在 Claude 中使用以下命令進行搜索：

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

服務器將處理請求並返回結構化的搜索結果。

✨ 主要特性

• 簡化的網絡搜索工具：允許 Claude 使用查詢參數直接進行網絡搜索。
• 可自定義的搜索參數：控制結果數量和即時爬取策略。
• 自動即時爬取：根據指定策略使用即時爬取。
• 預設最佳參數：使用默認值以獲得最佳效果。
• 搜索緩存：保存最近的搜索以便參考。
• 錯誤處理：優雅地處理 API 錯誤和速率限制。
• 類型安全：完整的 TypeScript 實現，帶有 Zod 驗證。
• MCP 合規性：完全實現最新的 MCP 協議規範。

🔍 使用 MCP 檢查器進行測試

你可以使用 MCP 檢查器直接測試服務器：

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

這將打開一個交互式界面，讓你可以探索服務器的功能、執行搜索查詢並查看緩存的搜索結果。

🔧 技術細節

故障排除

常見問題

1. 服務器未找到

   • 確認 npm 鏈接已正確設置。
   • 檢查 Claude Desktop 配置語法是否正確。
   • 確保 Node.js 已正確安裝。

2. API 密鑰問題

   • 確認你的 EXA_API_KEY 有效。
   • 檢查在 Claude Desktop 中 API 密鑰是否設置正確。
   • 確保 API 密鑰沒有空格或引號。

3. 連接問題

   • 完全重啟 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。