Tavily

🚀 MCP Tavily 項目

一個為 Tavily API 實現的模型上下文協議（MCP）服務器，提供高級搜索和內容提取功能，助力開發者高效完成相關任務。

中文文檔

🚀 快速開始

將 Tavily MCP 服務器添加到您的 MCP 配置中：

{
  "mcpServers": {
    "tavily": {
      "command": "npx",
      "args": ["-y", "@mcptools/mcp-tavily"],
      "env": {
        "TAVILY_API_KEY": "your-api-key"
      }
    }
  }
}

⚠️ 重要提示

請將 your-api-key 替換為您的實際 Tavily API 密鑰。

✨ 主要特性

• 多個搜索工具：
  • search：具有自定義選項的基本搜索功能。
  • searchContext：上下文感知搜索以提高相關性。
  • searchQNA：問答聚焦的搜索。
• 內容提取：從 URL 中提取內容，帶有可配置的選項。
• 豐富的配置選項：包括搜索深度、過濾和內容包含等方面的大量選項。

📦 安裝指南

安裝依賴

npm install

設置步驟

1. 克隆倉庫。
2. 安裝依賴：

   npm install
   

3. 配置您的 Tavily API 密鑰：

   export TAVILY_API_KEY=your_api_key
   

構建項目

npm run build

💻 使用示例

基礎用法

推薦使用 MCP Inspector 進行開發和調試，它提供了工具調用測試界面、服務器響應查看、調試工具執行以及服務器狀態監控等功能。

📚 詳細文檔

API 參考

搜索工具

• search：基本搜索功能，支持自定義過濾和排序選項。
• searchContext：提供上下文感知的搜索結果，增強相關性。
• searchQNA：聚焦於問答場景的搜索功能。

提取工具

• extract：從指定 URL 中提取結構化內容。

響應格式

所有工具的響應都遵循統一的數據格式，確保兼容性和易用性。

錯誤處理

詳細的錯誤信息和狀態碼，幫助開發者快速定位問題。

🤝 貢獻指南

歡迎貢獻！請按照以下步驟提交 Pull Request：

1. 叉叉倉庫。
2. 創建功能分支 (git checkout -b feature/AmazingFeature)。
3. 提交更改 (git commit -m 'Add some AmazingFeature')。
4. 推送到分支 (git push origin feature/AmazingFeature)。
5. 打開 Pull Request。

📄 許可證

本項目使用 MIT 許可證。

🛠️ 支持

如需幫助或遇到問題：

• Tavily API：參考 Tavily 文檔
• MCP 集成：參考 MCP 文檔