使用说明
Tavily MCP服务器🚀
🔌 兼容 克莱恩, 光标, 克劳德桌面,以及任何其他MCP客户端!
Tavily MCP也与任何MCP客户端兼容
📚 教程 关于Tavily MCP与Neo4j MCP服务器的结合!
📚 教程 在VS代码中将Tavily MCP与Cline集成(演示+示例用例)
模型上下文协议(MCP)是一个开放标准,使人工智能系统能够与各种数据源和工具无缝交互,促进安全的双向连接。
由Anthropic开发的模型上下文协议(MCP)使像Claude这样的人工智能助手能够与Tavily的高级搜索和数据提取功能无缝集成。这种集成为人工智能模型提供了对网络信息的实时访问,并配有复杂的过滤选项和特定领域的搜索功能。
Tavily MCP服务器提供:
- 与海量搜索和海量提取工具无缝交互
- 通过tavily搜索工具实现实时网络搜索功能
- 通过tavily提取工具从网页中智能提取数据
先决条件🔧
在开始之前,请确保您已经:
- Tavilly API密钥
- 如果您没有Tavily API密钥,您可以注册一个免费帐户 这里
- 克劳德桌面 或 光标
- Node.js (v20或更高)
- 您可以通过运行以下命令来验证您的Node.js安装:
node --version
- 您可以通过运行以下命令来验证您的Node.js安装:
- Git 已安装(仅在使用Git安装方法时需要)
- 在 macOS 上:
brew install git - 在Linux上:
- Debian/Ubuntu:
sudo apt install git - RedHat/CentOS:
sudo yum install git
- Debian/Ubuntu:
- 在Windows上:下载 Git for Windows
- 在 macOS 上:
Tavily MCP服务器安装⚡
使用NPX运行
npx -y tavily-mcp@0.1.4
通过Smithery安装
通过以下方式自动安装Tavily MCP Server for Claude Desktop 史密瑟里:
npx -y @smithery/cli install @tavily-ai/tavily-mcp --client claude
虽然您可以单独启动服务器,但单独启动并不是特别有用。相反,您应该将其集成到MCP客户端中。下面是一个如何配置Claude Desktop应用程序以与tavily mcp服务器一起工作的示例。
配置MCP客户端⚙️
此存储库将解释如何配置这两个 光标 和 克劳德桌面 使用tavily mcp服务器。
配置Cline🤖
在Cline中设置Tavily MCP服务器的最简单方法是单击一下市场:
- 在VS代码中打开Cline
- 点击侧边栏中的Cline图标
- 导航到“MCP服务器”选项卡(4个方块)
- 搜索“Tavily”并单击“安装”
- 提示时,输入Tavily API密钥
或者,您可以在Cline中手动设置Tavily MCP服务器:
-
打开Cline MCP设置文件:
对于macOS:
# Using Visual Studio Code code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json # Or using TextEdit open -e ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json对于Windows:
code %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json -
将Tavily服务器配置添加到文件中:
替换
your-api-key-here与你的实际 Tavilly API密钥.{ "mcpServers": { "tavily-mcp": { "command": "npx", "args": ["-y", "tavily-mcp@0.1.4"], "env": { "TAVILY_API_KEY": "your-api-key-here" }, "disabled": false, "autoApprove": [] } } } -
保存文件并重新启动Cline(如果它已经在运行)。
-
使用Cline时,您现在可以访问Tavily MCP工具。您可以要求Cline在对话中直接使用两种搜索和两种提取工具。
配置光标🖥️
备注:需要Cursor 0.45.6或更高版本
在Cursor中设置Tavily MCP服务器:
- 打开光标设置
- 导航到功能>MCP服务器
- 点击“+添加新MCP服务器”按钮
- 填写以下信息:
- 名字:输入服务器的昵称(例如“tavily mcp”)
- 类型:选择“command”作为类型
- 命令:输入运行服务器的命令:
env TAVILY_API_KEY=your-api-key npx -y tavily-mcp@0.1.4重要:替换
your-api-key使用Tavilly API密钥。你可以在 app.tavily.com/home
添加服务器后,它应该出现在MCP服务器列表中。您可能需要手动按下MCP服务器右上角的刷新按钮来填充工具列表。
Composer Agent将在与您的查询相关时自动使用Tavily MCP工具。最好通过描述你想做什么来明确要求使用这些工具(例如,“用户不断搜索以在网络上搜索有关人工智能的最新消息”)。在mac上按command+L打开聊天,选择屏幕顶部的composer选项,在提交按钮旁边选择代理,并在准备就绪时提交查询。
配置Claude Desktop应用程序🖥️
对于macOS:
# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"
# Opens the config file in TextEdit
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"
# Alternative method using Visual Studio Code (requires VS Code to be installed)
code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"
对于Windows:
code %APPDATA%\Claude\claude_desktop_config.json
添加Tavily服务器配置:
替换 your-api-key-here 与你的实际 Tavilly API密钥.
{
"mcpServers": {
"tavily-mcp": {
"command": "npx",
"args": ["-y", "tavily-mcp@0.1.2"],
"env": {
"TAVILY_API_KEY": "your-api-key-here"
}
}
}
}
2.Git安装
- 克隆存储库:
git clone https://github.com/tavily-ai/tavily-mcp.git
cd tavily-mcp
- 安装依赖项:
npm install
- 构建项目:
npm run build
配置Claude Desktop应用程序⚙️
按照中概述的配置步骤进行操作 配置Claude Desktop应用程序 使用下面的JSON配置。
替换 your-api-key-here 与你的实际 Tavilly API密钥 和 /path/to/tavily-mcp 使用您在系统上克隆存储库的实际路径。
{
"mcpServers": {
"tavily": {
"command": "npx",
"args": ["/path/to/tavily-mcp/build/index.js"],
"env": {
"TAVILY_API_KEY": "your-api-key-here"
}
}
}
}
在Claude桌面应用程序中的使用🎯
一旦安装完成,并且配置了Claude桌面应用程序,您必须完全关闭并重新打开Claude桌面程序才能看到tavily mcp服务器。您应该在应用程序的左下角看到一个锤子图标,指示可用的MCP工具,您可以单击锤子图标查看更多关于两次搜索和两次提取工具的详细信息。
现在,claude将可以完全访问tavily mcp服务器,包括tavily搜索和tavily提取工具。如果你将以下示例插入到Claude桌面应用程序中,你应该会看到tavily mcp服务器工具正在运行。
Tavily搜索示例
- 一般网络搜索:
Can you search for recent developments in quantum computing?
- 新闻搜索:
Search for news articles about AI startups from the last 7 days.
- 特定域搜索:
Search for climate change research on nature.com and sciencedirect.com
Tavily提取物示例
- 摘录文章内容:
Extract the main content from this article: https://example.com/article
✨ 结合搜索和提取✨
您还可以结合两种搜索和两种提取工具来执行更复杂的任务。
Search for news articles about AI startups from the last 7 days and extract the main content from each article to generate a detailed report.
故障排除🛠️
常见问题
-
找不到服务器
- 通过运行验证npm安装
npm --verison - 通过运行以下命令检查Claude Desktop配置语法
code ~/Library/Application\ Support/Claude/claude_desktop_config.json - 通过运行以下命令确保Node.js已正确安装
node --version
- 通过运行验证npm安装
-
NPX相关问题
- 如果您遇到与以下内容相关的错误
npx,您可能需要使用npx可执行文件的完整路径。 - 你可以通过跑步找到这条路
which npx在您的终端中,然后更换"command": "npx"带有"command": "/full/path/to/npx"在您的配置中。
- API关键问题
- 确认您的Tavily API密钥有效
- 检查配置中是否正确设置了API密钥
- 验证API键周围没有空格或引号