🚀 示例 MCP 服务器 🔍

本示例 MCP 服务器可让像Claude这样的AI助手，借助Exa AI搜索API进行网络搜索。如此一来，AI模型能实时获取网络信息，且运行于安全可控的环境中。

演示视频：点击查看

🚀 快速开始

本示例MCP服务器允许AI助手使用Exa AI搜索API执行网络搜索，让AI模型能实时获取网络信息。下面为你介绍其相关信息、安装配置及使用方法。

✨ 主要特性

什么是MCP？ 🤔

模型上下文协议（MCP）是一个系统，允许AI应用程序（如Claude桌面版）连接到外部工具和服务数据源。它提供了一个清晰且安全的方式，让AI助手与本地服务和API交互，同时让用户保持控制。

这个服务器的作用是什么？ 🚀

Exa MCP服务器具备以下功能：

• 允许AI助手使用Exa强大的搜索API执行网络搜索。
• 提供结构化的搜索结果，包括标题、URL和内容片段。
• 平滑处理速率限制和错误情况。

📦 安装指南

先决条件 📋

在开始之前，请确保您有：

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

您可以运行以下命令验证Node.js的安装：

node --version  # 应显示v18.0.0或更高版本

安装步骤 🛠️

1. 克隆仓库：

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

2. 安装依赖项：

npm install --save axios dotenv

3. 构建项目：

npm run build

4. 创建全局链接（此操作使服务器可以从任何位置执行）：

npm link

⚙️ 配置指南

1. Claude桌面版配置

将Claude桌面版配置为识别Exa MCP服务器： 您也可以在Claude桌面版的设置中找到claude_desktop_config.json文件。

对于macOS：

1. 打开您的Claude桌面版配置：

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

对于Windows：

1. 打开您的Claude桌面版配置：

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密钥。

2. 环境变量配置

在终端或命令提示符中设置以下环境变量：

# 对于macOS 或 Linux
export EXA_API_KEY=your-api-key-here

# 对于 Windows
set EXA_API_KEY=your-api-key-here

将 your-api-key-here 替换为您实际的Exa API密钥。

💻 使用示例

基础用法

1. 启动服务器：

npm start

2. 访问控制台以获取帮助命令：

mcp-cli --help

3. 将Claude桌面版连接到此MCP服务器。有关详细信息，请参阅claude-mcp文档。

📚 详细文档

如果遇到问题，请参考MCP 文档

🙏 致谢

• Exa AI（https://exa.ai）提供了强大的搜索API
• 模型上下文协议（https://modelcontextprotocol）