Exa MCP Server Heroku

Exa MCP服务器🔍


](https://www.npmjs.com/package/exa-mcp-server) ](https://smithery.ai/server/exa)

模型上下文协议（MCP）服务器允许像Claude这样的人工智能助手使用Exa人工智能搜索API进行网络搜索。这种设置允许AI模型以安全和可控的方式获取实时网络信息。

远程检查MCP🌐

直接连接到Exa的托管MCP服务器（而不是在本地运行）。

远程考试MCP URL

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

替换 your-api-key-here 使用来自的Exa API密钥 dashboard.exa.ai/api-keys.

远程MCP的Claude桌面配置

将此添加到您的Claude Desktop配置文件中：

{
  "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 mcp add exa -e EXA_API_KEY=YOUR_API_KEY -- npx -y exa-mcp-server

使用Smithery

通过以下方式自动安装Claude Desktop的Exa MCP服务器 史密瑟里:

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

配置⚙️

1.配置Claude Desktop以识别Exa MCP服务器

您可以在claude desktop应用程序的设置中找到claude_desktop_config.json：

打开Claude Desktop应用程序，从左上角菜单栏启用开发人员模式。

启用后，打开“设置”（也是从左上角菜单栏），导航到“开发人员选项”，您将在其中找到“编辑配置”按钮。点击它将打开claude_desktop_config.json文件，允许您进行必要的编辑。

或者（如果你想从终端打开claude_desktop_config.json）

对于macOS：

1. 打开您的Claude Desktop配置：

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

对于Windows：

1. 打开您的Claude Desktop配置：

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 使用来自的Exa API密钥 dashboard.exa.ai/api-keys.

3.可用工具和工具选择

Exa MCP服务器包括以下工具，可以通过添加 --tools:

• web_search_exa：执行实时网络搜索，优化结果和内容提取。
• 公司_研究：全面的公司研究工具，可抓取公司网站以收集有关企业的详细信息。
• 爬行：从特定URL中提取内容，当您有确切的URL时，可用于阅读文章、PDF或任何网页。
• linkedin_search：使用Exa AI在领英搜索公司和个人。只需在查询中包含公司名称、人名或特定的领英网址。
• 深度搜索开始：为复杂的问题启动一个聪明的人工智能研究人员。人工智能将搜索网络，阅读许多来源，并深入思考您的问题，以创建详细的研究报告。
• deep_researcher_check：检查你的研究是否准备好了，并得到结果。在开始一项研究任务后使用此工具，看看它是否已经完成，并得到你的综合报告。

您可以通过添加来选择要启用的工具 --tools Claude Desktop配置的参数：

指定要启用的工具：

{
  "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"
      }
    }
  }
}

要启用多个工具，请使用逗号分隔的列表：

{
  "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.重新启动克劳德桌面

要使更改生效，请执行以下操作：

1. 完全退出Claude Desktop（不仅仅是关闭窗口）
2. 重新启动克劳德桌面
3. 查找图标以验证Exa服务器是否已连接

通过NPX使用

如果你更喜欢直接运行服务器，你可以使用npx：

# Run with all tools enabled by default
npx exa-mcp-server

# Enable specific tools only
npx exa-mcp-server --tools=web_search_exa

# Enable multiple tools
npx exa-mcp-server --tools=web_search_exa,company_research

# List all available tools
npx exa-mcp-server --list-tools

故障排除🔧

常见问题

1. 找不到服务器

- 验证npm链接是否设置正确 - 检查Claude Desktop配置语法（json文件）

1. API关键问题

- 确认您的EXA_API_KEY有效 - 检查在Claude Desktop配置中是否正确设置了EXA_API_KEY - 验证API键周围没有空格或引号

1. 连接问题

- 完全重新启动克劳德桌面 - 检查克劳德桌面日志：

______________________________________________________________________

内置于❤️ 通过团队Exa

部署到Heroku🚀

您可以使用Heroku按钮一键将此MCP服务器部署到Heroku：


手动Heroku部署

如果您更喜欢手动部署：

1. 克隆此存储库：

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

1. 创建一个新的Heroku应用程序：

   heroku create

1. 将Exa API密钥设置为配置变量：

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

1. （可选）指定要启用的工具：

   heroku config:set ENABLED_TOOLS=web_search_exa,company_research_exa,crawling_exa

1. 部署到Heroku：

   git push heroku main

与Heroku推理和代理一起使用🤖

此MCP服务器与Heroku托管推理和代理完全兼容。要使用它：

1. 使用上述步骤将MCP服务器部署到Heroku。

1. 将MCP服务器连接到Heroku管理推理和代理聊天模型：

   # Replace APP_NAME with your Heroku app name
   # Replace MODEL_NAME with your desired model name
   heroku ai:models:create MODEL_NAME -a APP_NAME --as INFERENCE

1. 您的MCP服务器将自动向Heroku Inference注册，其工具将通过 /v1/agents/heroku 终点。

MCP服务器配置

此服务器对Heroku推理使用以下Procfile配置：

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

这 mcp-search-exa 进程按照Heroku要求的命名约定（进程名称必须以“mcp”开头）在Heroku推理中注册。直接执行Node.js可确保MCP协议的正确stdio处理。

根据Heroku对mcp服务器的建议，在app.json中默认情况下，web和mcp搜索exa-dynos都配置为扩展到0。当您将此应用程序附加到Heroku推理模型时，Heroku将根据工具执行的需要自动扩展MCP流程。

与Claude Desktop一起使用

要将Heroku部署的MCP服务器与Claude Desktop一起使用：

1. 将此添加到您的Claude Desktop配置文件中：

{
  "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 Code 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服务器存储库中删除，同时保留所有Heroku特定的自定义设置。更新是通过GitHub Actions处理的。

自动更新

GitHub Actions工作流每天运行，以：

• 从原始exa-mcp服务器存储库获取最新更改
• 保留所有Heroku特定的自定义设置（app.json、Procfile等）
• 提交并推送更新的代码

您还可以通过以下方式手动触发更新：

1. 转到GitHub存储库中的“操作”选项卡
2. 选择“上游自动更新”工作流
3. 点击“运行工作流”

手动更新

如果您更喜欢手动更新，可以使用附带的更新脚本：

1. 克隆您的分叉存储库：

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

1. 运行更新脚本：

   ./update-from-upstream.sh

1. 查看更改，然后提交并推送到您的存储库：

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

1. 如果您已经部署到Heroku，请更新您的Heroku应用程序：

   git push heroku main

更新过程保留了所有Heroku特定的自定义设置，包括：

• Heroku按钮配置（app.json）
• 过程定义（Procfile）
• 环境变量处理
• Heroku特定脚本
• 部署说明