Exa MCP 完整使用指南 - Brezza技术文档

📋 概述

了解Exa MCP服务器的核心功能和优势

Exa MCP Server 是一个Model Context Protocol (MCP) 服务器，让AI助手（如Claude）能够使用Exa AI搜索API进行网页搜索。这个设置允许AI模型以安全和受控的方式获取实时网络信息。

🚀 快速开始

三种配置方案，选择最适合你的方式

方案1: 托管服务器连接 (推荐)

直接连接到Exa的托管MCP服务器，无需本地安装：

JSON

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

方案2: 本地服务器安装

使用你的Exa API密钥进行本地安装：

JSON

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

方案3: Claude Code 命令行配置

Bash

                            # 添加Exa MCP服务器
claude mcp add exa -e EXA_API_KEY="your-api-key" -- npx -y exa-mcp-server

# 或使用本地安装的版本
claude mcp add exa -e EXA_API_KEY="your-api-key" -- /usr/lib/node_modules/exa-mcp-server/.smithery/index.cjs
                        

🛠️ 可用工具详解

五大核心工具，满足不同场景需求

1. web_search_exa

功能: 实时网页搜索，优化结果和内容提取

使用场景: 搜索最新新闻和信息、技术文档查找、市场研究

示例: "搜索2024年AI技术趋势"

2. company_research

功能: 综合企业研究工具，爬取公司网站收集详细信息

使用场景: 竞争对手分析、投资研究、商业情报收集

示例: "研究OpenAI公司的最新发展"

3. crawling

功能: 从特定URL提取内容

使用场景: 阅读文章、PDF或网页内容、内容摘要生成、信息验证

示例: "提取这个URL的内容: https://example.com/article"

4. linkedin_search

功能: 使用Exa AI搜索LinkedIn上的公司和人员

使用场景: 人才招聘、行业专家查找、商业网络建立

示例: "搜索机器学习领域的LinkedIn专家"

5. deep_researcher_start

功能: 为复杂问题启动智能AI研究员

使用场景: 学术研究、市场分析、多角度问题分析

示例: "深度研究区块链技术的未来发展"

🔑 API密钥管理

安全配置和管理你的Exa API密钥

1

获取API密钥

访问 https://dashboard.exa.ai/api-keys，注册账户并获取API密钥

2

密钥配置

环境变量: EXA_API_KEY=your-key-here
配置文件: 在JSON配置中设置
命令行: 使用-e参数传递

3

安全保护

使用环境变量存储密钥、定期轮换API密钥、监控API使用情况

当前配置状态

API密钥: f2d1bd3c-c901-4205-82e4-b704dc073925
服务器状态: ✓ Connected
部署状态: ✅ 已部署并正常运行

🚨 故障排查

常见问题解决方案和调试方法

常见问题

1. 连接失败

Bash

                            # 检查服务器状态
claude mcp list

# 验证API密钥
echo $EXA_API_KEY
                        

2. 工具不可用

Bash

                            # 重新安装
npm uninstall -g exa-mcp-server
npm install -g exa-mcp-server
                        

3. 配置错误

Bash

                            # 检查配置
claude mcp get exa

# 重新配置
claude mcp remove exa
claude mcp add exa -e EXA_API_KEY="your-key" -- npx -y exa-mcp-server
                        

调试模式

启用MCP调试: claude --mcp-debug
查看详细日志: npx exa-mcp-server --verbose

🔍 技术背景

Model Context Protocol (MCP) 协议介绍

Model Context Protocol (MCP)

发布时间: 2024年11月由Anthropic发布
协议标准: JSON-RPC 2.0
SDK支持: Python SDK 和 TypeScript SDK

MCP优势

标准化集成

提供一致的接口，简化AI工具连接

减少重复开发

单一MCP服务器实现适用于多个客户端

避免供应商锁定

可在LLM提供商之间灵活切换

提高可扩展性

通过标准化集成提高系统维护性