tavily-search
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tavily-search search for latest AI news"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Tavily Search MCP Server 🔍
让你的 AI Agent 拥有实时的网络搜索能力!
一个基于 Model Context Protocol (MCP) 的服务器,为 Claude Desktop、Cursor、Hermes Agent 等支持 MCP 的 AI 客户端提供实时网络搜索和网页内容提取能力。
✨ 功能
工具 | 描述 |
| 搜索互联网获取实时信息。支持通用搜索、新闻搜索、金融数据。返回带标题、URL 和摘要的格式化结果。 |
| 从一个或多个 URL 提取干净、LLM 可读的网页内容。完美适用于阅读文章、文档等。 |
Related MCP server: Tavily MCP Server
🚀 快速开始
1. 安装
pip install mcp-tavily-search或者从源码安装:
git clone https://github.com/lingxi-dev/mcp-tavily-search.git
cd mcp-tavily-search
pip install -e .2. 设置 API Key
# Linux / macOS
export TAVILY_API_KEY="tavily-xxxxxxxxxxxxxxxx"
# Windows (cmd)
set TAVILY_API_KEY=tavily-xxxxxxxxxxxxxxxx
# Windows (PowerShell)
$env:TAVILY_API_KEY="tavily-xxxxxxxxxxxxxxxx"也可以在项目目录创建 .env 文件:
TAVILY_API_KEY=tavily-xxxxxxxxxxxxxxxx获取 API Key:app.tavily.com
3. 启动服务器
# stdio 模式(默认,适用于 Claude Desktop 等本地客户端)
mcp-tavily-search
# SSE 模式(适用于远程/网络连接)
mcp-tavily-search --transport sse --host 0.0.0.0 --port 80004. 配置 Claude Desktop
编辑 claude_desktop_config.json:
{
"mcpServers": {
"tavily-search": {
"command": "mcp-tavily-search",
"env": {
"TAVILY_API_KEY": "tavily-xxxxxxxxxxxxxxxx"
}
}
}
}5. 配置 Hermes Agent
在 ~/.hermes/config.yaml 中添加:
mcp_servers:
tavily-search:
command: mcp-tavily-search
env:
TAVILY_API_KEY: tavily-xxxxxxxxxxxxxxxx⚙️ 高级用法
搜索参数
# 搜索工具支持以下参数:
web_search_tool(
query="2026年 AI Agent 发展趋势",
max_results=10, # 结果数量 (1-20)
search_depth="advanced", # "basic" 快速 / "advanced" 高质量
include_answer=True, # 是否包含 AI 摘要
topic="news", # "general" / "news" / "finance"
days=30 # 回溯天数
)提取内容
extract_content_tool(
urls=[
"https://example.com/article1",
"https://example.com/article2"
]
)🏗️ 项目结构
mcp-tavily-search/
├── pyproject.toml # 项目配置 & 依赖
├── README.md # 本文档
├── LICENSE # MIT 许可证
├── .env.example # 环境变量模板
└── src/
└── mcp_tavily_search/
├── __init__.py
├── server.py # FastMCP 服务器入口
└── tools/
├── __init__.py
├── search.py # Tavily 搜索 API 封装
└── content.py # Tavily 内容提取 API 封装🔧 技术栈
FastMCP — MCP 服务器框架(官方推荐,70% MCP 服务器使用)
Tavily API — 为 AI Agent 优化的搜索引擎
httpx — 异步 HTTP 客户端
📦 发布到 PyPI
pip install build twine
python -m build
twine upload dist/*📄 许可证
MIT
Available Tools
2 toolsextract_content_toolA
Extract clean, LLM-readable content from one or more URLs. Useful for reading articles, documentation, or any web page content and making it available to the LLM for analysis.
Inputs: urls (required). Returns: result
web_search_toolA
Search the web for real-time information. Returns clean, LLM-optimized results with titles, URLs, snippets, and an optional AI-generated answer summary. Use this to find current information, news, documentation, or any web content.
Inputs: query (required), days, topic, max_results, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one for extracting content from URLs, the other for web search. No overlap or ambiguity.
Both tools follow a consistent verb_noun snake_case pattern with 'tool' suffix: extract_content_tool and web_search_tool.
Two tools is minimal but reasonable for a focused search server covering search and content extraction. Slightly under typical scopes but not insufficient.
Covers core search and content extraction, but missing advanced search options (filters, pagination) which are common in search servers.
Maintenance
Related MCP Connectors
Web data for agents. Extract web pages, crawl websites, discover URLs, and search the web.
LLM-ready web search + instant answers + URL-to-clean-text fetch for agents and RAG.
Web search and page reading for AI agents, including JSON APIs, RSS feeds and YouTube.
Web search, Google SERP, page extraction to markdown and cited answers for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceProvides AI-powered web search capabilities using Tavily's search API, enabling LLMs to perform sophisticated web searches, get direct answers to questions, and search recent news articles.72MIT
- AlicenseNot gradedqualityFmaintenanceEnables AI assistants to perform up-to-date web searches through the Tavily API, providing comprehensive search results with AI-generated summaries.7MIT
- AlicenseBqualityDmaintenanceProvides AI assistants with real-time web search capabilities and intelligent data extraction from web pages through Tavily's advanced search API.219,479 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform real-time web searches, extract data from web pages, map website structures, and crawl websites using the Tavily API.85 npmMIT