AI搜索协议服务器

Exa MCP服务器是一个允许AI助手通过Exa AI搜索API进行网络搜索的服务,提供结构化搜索结果和实时网络爬取功能。

  • by aditya002p
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 aditya002p/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服务器包括以下工具:

  • web_search_exa:执行实时网络搜索,优化结果和内容提取。
  • 研究人员调查:专注于学术论文和研究内容的专业搜索。
  • 推特搜索:专门的Twitter/X.com搜索,查找推文、个人资料和对话。
  • 公司_研究:全面的公司研究工具,可抓取公司网站以收集有关企业的详细信息。
  • 爬行:从特定URL中提取内容,当您有确切的URL时,可用于阅读文章、PDF或任何网页。
  • 竞争对手_发现者:通过搜索提供类似产品或服务的企业来识别公司的竞争对手。
  • linkedin_search:使用Exa AI在领英搜索公司和个人。只需在查询中包含公司名称、人名或特定的领英网址。

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

指定要启用的工具:

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

要使更改生效,请执行以下操作:

  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,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检验员测试🔍

您可以直接使用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"
    

致谢🙏