Exa MCP Server Heroku

🚀 Exa MCP Server 🔍

Exa MCP Server 是一個模型上下文協議（MCP）服務器，它允許像 Claude 這樣的 AI 助手使用 Exa AI 搜索 API 進行網絡搜索。通過這種設置，AI 模型能夠以安全且可控的方式獲取即時網絡信息。

🚀 快速開始

遠程 Exa MCP 🌐

可以直接連接到 Exa 託管的 MCP 服務器（而不是在本地運行）。

遠程 Exa MCP URL

https://mcp.exa.ai/mcp?exaApiKey=your-exa-api-key

請將 your-api-key-here 替換為你從 dashboard.exa.ai/api-keys 獲取的實際 Exa API 密鑰。

Claude 桌面端遠程 MCP 配置

在你的 Claude 桌面端配置文件中添加以下內容：

{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.exa.ai/mcp?exaApiKey=your-exa-api-key"
      ]
    }
  }
}

NPM 安裝

npm install -g exa-mcp-server

使用 Claude 代碼

claude mcp add exa -e EXA_API_KEY=YOUR_API_KEY -- npx -y exa-mcp-server

使用 Smithery

要通過 Smithery 自動為 Claude 桌面端安裝 Exa MCP 服務器，請執行以下命令：

npx -y @smithery/cli install exa --client claude

📦 安裝指南

配置 ⚙️

1. 配置 Claude 桌面端以識別 Exa MCP 服務器

你可以在 Claude 桌面端應用的設置中找到 claude_desktop_config.json 文件。具體操作如下： 打開 Claude 桌面端應用，從左上角菜單欄啟用開發者模式。啟用後，打開設置（同樣從左上角菜單欄），導航到開發者選項，找到“編輯配置”按鈕。點擊該按鈕將打開 claude_desktop_config.json 文件，你可以在其中進行必要的編輯。

或者（如果你想從終端打開 claude_desktop_config.json）：

• macOS：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

• Windows：

code %APPDATA%\Claude\claude_desktop_config.json

2. 添加 Exa 服務器配置

{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": ["-y", "exa-mcp-server"],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

請將 your-api-key-here 替換為你從 dashboard.exa.ai/api-keys 獲取的實際 Exa API 密鑰。

3. 可用工具及工具選擇

Exa MCP 服務器包含以下工具，你可以通過添加 --tools 參數來啟用它們：

• web_search_exa：執行即時網絡搜索，提供優化結果和內容提取功能。
• company_research：全面的公司研究工具，可爬取公司網站以收集有關企業的詳細信息。
• crawling：從特定 URL 提取內容，當你有確切的 URL 時，可用於閱讀文章、PDF 或任何網頁。
• linkedin_search：使用 Exa AI 在 LinkedIn 上搜索公司和人員。只需在查詢中包含公司名稱、人員姓名或特定的 LinkedIn URL 即可。
• deep_researcher_start：為複雜問題啟動智能 AI 研究人員。AI 將搜索網絡、閱讀多個來源，並深入思考你的問題，以創建詳細的研究報告。
• deep_researcher_check：檢查你的研究是否完成並獲取結果。在啟動研究任務後使用此工具，查看是否完成並獲取全面的報告。

你可以通過在 Claude 桌面端配置中添加 --tools 參數來選擇要啟用的工具：

{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": [
        "-y",
        "exa-mcp-server",
        "--tools=web_search_exa,company_research,crawling,linkedin_search,deep_researcher_start,deep_researcher_check"
      ],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

如果你想啟用多個工具，請使用逗號分隔的列表。如果你未指定任何工具，將使用所有默認啟用的工具。

4. 重啟 Claude 桌面端

要使更改生效，請執行以下操作：

1. 完全退出 Claude 桌面端（不僅僅是關閉窗口）。
2. 再次啟動 Claude 桌面端。
3. 查找圖標以驗證 Exa 服務器是否已連接。

通過 NPX 使用

如果你更喜歡直接運行服務器，可以使用 npx：

# 默認啟用所有工具運行
npx exa-mcp-server

# 僅啟用特定工具
npx exa-mcp-server --tools=web_search_exa

# 啟用多個工具
npx exa-mcp-server --tools=web_search_exa,company_research

# 列出所有可用工具
npx exa-mcp-server --list-tools

🔧 故障排除

常見問題

1. 未找到服務器
   • 驗證 npm 鏈接是否正確設置。
   • 檢查 Claude 桌面端配置語法（JSON 文件）。
2. API 密鑰問題
   • 確認你的 EXA_API_KEY 有效。
   • 檢查 EXA_API_KEY 是否在 Claude 桌面端配置中正確設置。
   • 驗證 API 密鑰周圍沒有空格或引號。
3. 連接問題
   • 完全重啟 Claude 桌面端。
   • 檢查 Claude 桌面端日誌。

🚀 部署到 Heroku

你可以使用 Heroku 按鈕一鍵將此 MCP 服務器部署到 Heroku：

手動 Heroku 部署

如果你更喜歡手動部署，請按以下步驟操作：

1. 克隆此倉庫：

git clone https://github.com/dsouza-anush/exa-mcp-server-heroku.git
cd exa-mcp-server-heroku

2. 創建一個新的 Heroku 應用：

heroku create

3. 將你的 Exa API 密鑰設置為配置變量：

heroku config:set EXA_API_KEY=your-api-key-here

4. 可選：指定要啟用的工具：

heroku config:set ENABLED_TOOLS=web_search_exa,company_research_exa,crawling_exa

5. 部署到 Heroku：

git push heroku main

🤖 與 Heroku Inference 和 Agents 一起使用

此 MCP 服務器與 Heroku Managed Inference 和 Agents 完全兼容。要使用它，請按以下步驟操作：

1. 使用上述步驟將 MCP 服務器部署到 Heroku。
2. 將 MCP 服務器附加到 Heroku Managed Inference 和 Agents 聊天模型：

# 將 APP_NAME 替換為你的 Heroku 應用名稱
# 將 MODEL_NAME 替換為你想要的模型名稱
heroku ai:models:create MODEL_NAME -a APP_NAME --as INFERENCE

3. 你的 MCP 服務器將自動在 Heroku Inference 中註冊，其工具將通過 /v1/agents/heroku 端點可用。

MCP 服務器配置

此服務器在 Heroku Inference 中使用以下 Procfile 配置：

web: npm run serve
mcp-search-exa: node ./stdio-server.js

mcp-search-exa 進程已在 Heroku Inference 中註冊，遵循 Heroku 要求的命名約定（進程名稱必須以 "mcp" 開頭）。直接執行 Node.js 可確保為 MCP 協議正確處理標準輸入輸出。

在 app.json 中，web 和 mcp-search-exa dynos 默認配置為擴展到 0，遵循 Heroku 對 MCP 服務器的建議。當你將此應用附加到 Heroku Inference 模型時，Heroku 將根據工具執行的需要自動擴展 MCP 進程。

與 Claude 桌面端一起使用

要將你在 Heroku 上部署的 MCP 服務器與 Claude 桌面端一起使用，請在你的 Claude 桌面端配置文件中添加以下內容：

{
  "mcpServers": {
    "exa_heroku": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-app-name.herokuapp.com/mcp"
      ],
      "env": {
        "EXA_API_KEY": "your-api-key-here" 
      }
    }
  }
}

請將 your-app-name 替換為你的 Heroku 應用名稱，將 your-api-key-here 替換為你的 Exa API 密鑰。

與 Claude 代碼 CLI 一起使用

claude mcp add exa_heroku -e EXA_API_KEY=YOUR_API_KEY -- npx -y mcp-remote https://your-app-name.herokuapp.com/mcp

請將 your-app-name 替換為你的 Heroku 應用名稱，將 YOUR_API_KEY 替換為你的 Exa API 密鑰。

🔄 與上游保持同步

此倉庫每天會自動從原始的 exa-mcp-server 倉庫更新，同時保留所有特定於 Heroku 的自定義設置。更新通過 GitHub Actions 處理。

自動更新

GitHub Actions 工作流每天運行一次，執行以下操作：

• 從原始的 exa-mcp-server 倉庫獲取最新更改。
• 保留所有特定於 Heroku 的自定義設置（如 app.json、Procfile 等）。
• 提交併推送更新後的代碼。

你也可以手動觸發更新，方法如下：

1. 轉到 GitHub 倉庫的“Actions”選項卡。
2. 選擇“Auto Update from Upstream”工作流。
3. 點擊“Run workflow”。

手動更新

如果你更喜歡手動更新，可以使用包含的更新腳本：

1. 克隆你的分叉倉庫：

git clone https://github.com/your-username/exa-mcp-server-heroku.git
cd exa-mcp-server-heroku

2. 運行更新腳本：

./update-from-upstream.sh

3. 審查更改，然後提交併推送到你的倉庫：

git commit -am "Updated from upstream with Heroku customizations"
git push origin main

4. 如果你已經部署到 Heroku，請更新你的 Heroku 應用：

git push heroku main

更新過程將保留所有特定於 Heroku 的自定義設置，包括：

• Heroku 按鈕配置（app.json）
• 進程定義（Procfile）
• 環境變量處理
• 特定於 Heroku 的腳本
• 部署說明

由 Exa 團隊用心打造 ❤️