扩展MCP服务器

Name: 扩展MCP服务器
Author: theishangoswami

作者：theishangoswami6 星标更新：2024-12-01

安装使用来源：spider==github.com

项目介绍

Exa MCP Server 🔍

Model Context Protocol (MCP) 服务器允许像 Claude 这样的AI助手使用 Exa AI 搜索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  # 应显示 v18.0.0 或更高版本

安装 🛠️

克隆仓库：

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

安装依赖项：

npm install --save axios dotenv

构建项目：

npm run build

创建全局链接（这使得可以从任何地方执行服务器）：

npm link

配置 ⚙️

1. Claude Desktop 配置

配置 Claude Desktop 以识别 Exa MCP 服务器：

您也可以在 Claude Desktop 应用程序的设置中找到 claude_desktop_config.json 文件

或者

对于 macOS：

打开您的 Claude Desktop 配置：

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

对于 Windows：

打开您的 Claude Desktop 配置：

code %APPDATA%\Claude\claude_desktop_config.json

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

2. 重启 Claude Desktop

为了让更改生效：

完全退出 Claude Desktop（不仅仅是关闭窗口）
再次启动 Claude Desktop
查找 🔌 图标以确认 Exa 服务器已连接

使用方法 🎯

一旦配置完成，您可以要求 Claude 执行网络搜索。这里有一些示例提示：

你能搜索一下量子计算的最新发展吗？

搜索并总结纽约人工智能初创公司的最新新闻。

查找并分析关于气候变化解决方案的近期研究论文。

服务器将：

处理搜索请求
查询 Exa API
将格式化的结果返回给 Claude
缓存搜索以便将来参考

特性 ✨

网络搜索工具：使 Claude 能够使用自然语言查询进行网络搜索
错误处理：优雅地处理API错误和速率限制
类型安全性：完整的 TypeScript 实现，具有正确的类型检查

故障排除 🔧

常见问题

未找到服务器
- 确认 npm 链接正确设置
- 检查 Claude Desktop 配置语法
- 确保 Node.js 正确安装
API 密钥问题
- 确认您的 Exa API 密钥有效
- 检查 API 密钥是否正确设置在 Claude Desktop 配置中
1. 确认 API 密钥周围没有空格或引号
连接问题
- 完全重启 Claude Desktop
- 检查 Claude Desktop 日志：
```
# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
```

获取帮助

如果您遇到问题，请查阅 MCP 文档

致谢 🙏

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