AI搜索服务

Exa MCP Server是一个允许AI助手通过Exa AI搜索API进行实时网络搜索的服务,提供结构化的搜索结果并支持多种搜索工具。

  • by meicanhong
  • 本地部署
  • 更新于
在 GitHub 查看 meicanhong/exa-mcp-server

使用说明

Exa MCP服务器🔍

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

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

什么是MCP? 🤔

模型上下文协议(MCP)是一个允许人工智能应用程序(如Claude Desktop)连接到外部工具和数据源的系统。它为AI助手提供了一种清晰安全的方式来使用本地服务和API,同时让用户保持控制。

这个服务器做什么? 🚀

Exa MCP服务器:

  • 使人工智能助手能够使用Exa强大的搜索API进行网络搜索
  • 提供结构化搜索结果,包括标题、URL和内容片段
  • 将最近的搜索缓存为参考资源
  • 优雅地处理速率限制和错误情况
  • 支持实时网络抓取新鲜内容

先决条件📋

在开始之前,请确保您已经:

您可以通过运行以下命令来验证您的Node.js安装:

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

安装🛠️

NPM安装

npm install -g exa-mcp-server

使用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
  1. 安装依赖项:
npm install
  1. 构建项目:
npm run build
  1. 创建全局链接(这使得服务器可以从任何地方执行):
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 使用来自的Exa API密钥 dashboard.exa.ai/api-keys.

3.可用工具和工具选择

Exa MCP服务器包括以下工具:

  • 网络搜索:执行实时网络搜索,优化结果和内容提取。
  • 研究人员调查:专注于学术论文和研究内容的专业搜索。
  • 推特搜索:专门的Twitter/X.com搜索,查找推文、个人资料和对话。

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

指定要启用的工具:

{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": [
        "/path/to/exa-mcp-server/build/index.js",
        "--tools=twitter_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,research_paper_search,twitter_search"
      ],
      "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

# Enable multiple tools
npx exa-mcp-server --tools=web_search,research_paper_search

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

用法🎯

配置后,您可以要求Claude执行网络搜索。以下是一些示例提示:

Can you search for recent developments in quantum computing?
Search for and summarize the latest news about artificial intelligence startups in new york.
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.

服务器将:

  1. 处理搜索请求
  2. 使用最佳设置(包括实时爬网)查询Exa API
  3. 将格式化结果返回给Claude
  4. 缓存搜索以供将来参考

MCP检验员测试🔍

您可以直接使用MCP检查器测试服务器:

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

这将打开一个交互式界面,您可以在其中探索服务器的功能、执行搜索查询和查看缓存的搜索结果。

故障排除🔧

常见问题

  1. 找不到服务器

    • 验证npm链接是否设置正确
    • 检查Claude Desktop配置语法
    • 确保Node.js安装正确
  2. API关键问题

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

    • 完全重新启动克劳德桌面
    • 检查克劳德桌面日志:
    # macOS
    tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
    
    # Windows
    type "%APPDATA%\Claude\logs\mcp*.log"
    

致谢🙏