Exa MCP Server 🔍

Exa MCP 服务 🔍

Model Context Protocol（MCP）服务让 Claude 等 AI 助手能够使用 Exa AI Search API 搜索网页。这种配置让 AI 模型能够以安全、可控的方式获取实时网页信息。

演示视频 https://www.loom.com/share/ac676f29664e4c6cb33a2f0a63772038?sid=0e72619f-5bfc-415d-a705-63d326373f60

什么是 MCP？🤔

Model Context Protocol（MCP）是一种系统，可让 Claude Desktop 等 AI 应用连接到外部工具和数据源。它为 AI 助手提供了一种清晰、安全的方式来使用本地服务和 API，同时让用户始终掌控全局。

此服务能做什么？🚀

Exa MCP 服务：

• 让 AI 助手能够使用 Exa 强大的搜索 API 搜索网页
• 提供结构化搜索结果，包括标题、URL 和内容摘要
• 将近期搜索缓存为资源，以供参考
• 妥善处理速率限制和错误情况
• 支持实时网页抓取，获取最新内容

前置条件 📋

开始之前，请确保已准备好：

• Node.js（v18 或更高版本）
• 已安装 Claude Desktop
• Exa API 密钥
• 已安装 Git

运行以下命令即可验证 Node.js 是否已安装：

node --version  # Should show v18.0.0 or higher

安装 🛠️

使用 NPM 安装

npm install -g exa-mcp-server

使用 Smithery

通过 Smithery 为 Claude Desktop 自动安装 Exa MCP 服务：

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

手动安装

1. 克隆仓库：

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

2. 安装依赖：

npm install

3. 构建项目：

npm run build

4. 创建全局链接（这样就能在任何位置运行此服务）：

npm link

配置 ⚙️

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": ["/path/to/exa-mcp-server/build/index.js"],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

将 your-api-key-here 替换为你在 dashboard.exa.ai/api-keys 获取的 Exa API 密钥。

3. 可用工具和工具选择

Exa MCP 服务包含以下工具：

• web_search_exa：使用经过优化的结果和内容提取功能进行实时网页搜索。
• research_paper_search：专门搜索学术论文和研究内容。
• twitter_search：专门搜索 Twitter/X.com，可查找推文、个人资料和对话。
• company_research：全面的公司研究工具，可抓取公司网站以收集企业的详细信息。
• crawling：从指定 URL 提取内容；如果你有确切的 URL，可用它来阅读文章、PDF 或任何网页。
• competitor_finder：通过搜索提供类似产品或服务的企业，找出某公司的竞争对手。
• linkedin_search：使用 Exa AI 搜索 LinkedIn 上的公司和人员。只需在查询中提供公司名称、人员姓名或特定的 LinkedIn URL。

你可以在 Claude Desktop 配置中添加 --tools 参数，选择要启用的工具：

指定要启用的工具：

{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": [
        "/path/to/exa-mcp-server/build/index.js",
        "--tools=web_search_exa,research_paper_search,twitter_search,company_research,crawling,competitor_finder,linkedin_search"
      ],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

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

{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": [
        "/path/to/exa-mcp-server/build/index.js",
        "--tools=web_search_exa,research_paper_search,twitter_search,company_research,crawling,competitor_finder,linkedin_search"
      ],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

如果未指定任何工具，则默认启用的所有工具都会被使用。

4. 重启 Claude Desktop

要使更改生效：

1. 完全退出 Claude Desktop（不要只关闭窗口）
2. 再次启动 Claude Desktop
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,research_paper_search

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

使用方法 🎯

配置完成后，你可以让 Claude 执行网页搜索。以下是一些提示词示例：

Can you search for recent developments in quantum computing?

Find and analyze recent research papers about climate change solutions.

Search Twitter for posts from @elonmusk about SpaceX.

Find tweets from @samaltman that were published in the last week about AI safety.

Research the company exa.ai and find information about their pricing and features.

Extract the content from this research paper: https://arxiv.org/pdf/1706.03762

Find competitors for a company that provides web search API services, excluding exa.ai from the results.

Find the LinkedIn profile for Anthropic company.

Search for data scientists at OpenAI on LinkedIn.

该服务将：

1. 处理搜索请求
2. 使用最佳设置查询 Exa API（包括实时抓取）
3. 将格式化结果返回给 Claude
4. 缓存搜索结果，供日后参考

使用 MCP Inspector 测试 🔍

你可以使用 MCP Inspector 直接测试该服务：

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

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

故障排除 🔧

常见问题

1. 未找到服务

   • 确认 npm link 已正确设置
   • 检查 Claude Desktop 配置语法
   • 确保已正确安装 Node.js

2. API 密钥问题

   • 确认你的 EXA_API_KEY 有效
   • 检查 Claude Desktop 配置中是否正确设置了 EXA_API_KEY
   • 确认 API 密钥周围没有空格或引号

3. 连接问题

   • 完全重启 Claude Desktop
   • 查看 Claude Desktop 日志：

   # macOS
   tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
   
   # Windows
   type "%APPDATA%\Claude\logs\mcp*.log"
   

致谢 🙏

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