MCP Tavily

🚀 Tav 語義上下文協議服務器

Tav 是一個用於實現模型上下文協議（Model Context Protocol）的服務器，該協議定義瞭如何藉助語言模型與外部知識源和網絡進行交互，能有效提升信息交互的效率和質量。

🚀 快速開始

Tav 是一個用於實現模型上下文協議（Model Context Protocol）的服務器。當前實現版本為 v0.5.0，支持從外部知識庫搜索信息、領域過濾、網頁內容摘要、生成引文格式報告以及直接返回網絡搜索結果等功能。

✨ 主要特性

1. 知識庫集成

支持多種知識庫來源，可通過配置環境變量來選擇不同的知識庫：

# 配置 Wikipedia 搜索
TAV_KNOWLEDGE_SOURCES="wikipedia"

# 啟用網絡搜索功能
TAV_NETWORK=True

2. 領域過濾

能夠通過 URL 過濾指定領域內容，示例如下：

curl -X POST http://localhost:8000/api/v1/chat/completions \
-d '{"model": "tav", "messages": [{"role": "user", "content": "Tell me about quantum computing. Please exclude arXiv sources."}]}'

3. 報告生成

支持多種引用格式，方便生成不同類型的報告：

curl -X POST http://localhost:8000/api/v1/chat/completions \
-d '{"model": "tav", "messages": [{"role": "user", "content": "Write a report on AI ethics in markdown with MLA citations. Include arXiv sources only."}]}'

📦 安裝指南

克隆倉庫

git clone git@github.com:modelcontextprotocol/mcp-tavily.git
cd mcp-tavily

運行服務器

python -m mcp_server_tavily

默認情況下，服務器將在端口 8000 上運行，並綁定到所有網絡接口。你也可以通過以下命令指定不同的端口：

TAV_PORT=8080 python -m mcp_server_tavily

配置環境變量

以下是常用的環境變量配置：

• TAV_API_KEY：用於身份驗證的 API 密鑰（必填）
• TAV_HOST：服務器綁定的主機地址，默認為 0.0.0.0
• TAV_PORT：服務器運行的端口，默認為 8000
• OPENAI_API_KEY：OpenAI API 的密鑰（可選，用於調用 GPT 模型）

💻 使用示例

基礎用法

生成摘要

curl -X POST http://localhost:8000/api/v1/chat/completions \
-d '{"model": "tav", "messages": [{"role": "user", "content": "Summarize the latest advancements in quantum computing."}]}'

返回搜索結果

curl -X POST http://localhost:8000/api/v1/chat/completions \
-d '{"model": "tav", "messages": [{"role": "user", "content": "Search for recent breakthroughs in AI and return direct results."}]}'

📚 詳細文檔

測試套件

項目提供了一個完整的測試套件，用於驗證功能的正確性：

uv sync --dev

運行測試後，您將看到類似以下輸出：

✓ Basic functionality test - 100ms
✓ Knowledge source integration - 200ms
✓ Citation formatting - 300ms

Docker 部署

構建鏡像

uv package --format docker:image --name tav-semantic-server .

運行容器

docker run -it --rm -p 8000:8000 \
-e TAV_API_KEY=your_api_key \
tav-semantic-server

調試工具

項目提供了一個調試界面，便於開發者進行調試：

uv debug .

訪問 http://localhost:5173 即可查看即時日誌和調試信息。

貢獻指南

歡迎貢獻代碼！請遵循以下流程：

1. 創建功能分支：git checkout -b feature/your-feature
2. 提交更改：git add . && git commit -m "feat: your new feature"
3. 推送分支：git push origin feature/your-feature
4. 創建 Pull Request

📄 許可證

本項目遵循 MIT 協議。請查看 LICENSE 文件獲取詳細信息。

👋 聯繫我們

如您有任何問題或建議，請聯繫：

• 郵箱：contact@modelcontextprotocol.org
• GitHub 倉庫：https://github.com/modelcontextprotocol/mcp-tavly