Traylinx Search Engine MCP Server

🚀 Traylinx 搜索引擎 MCP 服務器

Traylinx 搜索引擎 MCP 服務器是一個模型上下文協議（MCP）服務器，作為部署的 Agentic 搜索 API 的橋樑。它能讓 Claude Desktop 和 Cursor 這類 MCP 客戶端使用智能搜索功能，獲取詳細的文本摘要和結構化數據（如 HTML、圖像等）。

🚀 快速開始

Traylinx 搜索引擎 MCP 服務器的主要作用是連接 MCP 客戶端與 Agentic 搜索 API，藉助 search 工具，MCP 客戶端可以執行網絡搜索並獲取詳細結果。其工作流程為：接收搜索查詢，調用 Agentic 搜索 API，處理並格式化響應以供 MCP 客戶端使用。

✨ 主要特性

• 作為 MCP 客戶端與 Agentic 搜索 API 的橋樑，實現智能搜索功能。
• 支持多內容類型返回，包括文本摘要、結構化數據和新聞文章。
• 可通過時間過濾器篩選搜索結果。

📦 安裝指南

環境變量配置

需設置以下環境變量來配置服務器行為：

• AGENTIC_SEARCH_API_KEY：Agentic 搜索 API 的密鑰，為必填項。
• AGENTIC_SEARCH_ENDPOINT：可自定義 Agentic 搜索 API 的端點 URL，默認使用默認端點。

示例配置文件

{
  "environmentVariables": {
    "AGENTIC_SEARCH_API_KEY": "your_api_key_here",
    "AGENTIC_SEARCH_ENDPOINT": "https://api.agents.com/v1"
  }
}

💻 使用示例

基礎用法

search 工具可使用 Traylinx 的 API 執行網絡搜索，該 API 能提供詳細且與上下文相關的結果，並附有引用。默認情況下不應用時間過濾器。 輸入參數：

• query (字符串)：要執行的搜索查詢。
• search_recency_filter (字符串，可選)：按時間篩選搜索結果。可選值為 "month"、"week"、"day"、"hour"。若未指定，則默認不應用時間過濾器。

高級用法

多內容類型返回

服務器支持以下內容類型：

• 文本摘要：簡潔的搜索結果。
• 結構化數據：包含 URL、標題和描述。
• 新聞文章：帶有時間戳和縮略圖的文章。

時間過濾器用法

{
  "name": "search",
  "arguments": {
    "query": "SpaceX 發射",
    "search_recency_filter": "week"
  }
}

🔧 技術細節

工作原理

1. 項目介紹：Traylinx 搜索引擎 MCP 服務器充當 MCP 客戶端與 Agentic 搜索 API 之間的橋樑。
2. 工具說明：search 工具允許從 MCP 客戶端執行網絡搜索，並返回詳細結果。
3. 工作流程：
   • 接收搜索查詢。
   • 調用 Agentic 搜索 API。
   • 處理並格式化響應，供 MCP 客戶端使用。

📄 許可證

該項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

🔍 驗證方法

手動測試

可運行以下命令驗證服務器是否正常工作：

curl -X POST http://localhost:3000/api/search \
     -H "Content-Type: application/json" \
     -d '{"query": "latest tech news", "search_recency_filter": "day"}'

自動化測試腳本

const fetch = require('node-fetch');

async function testSearch() {
    const response = await fetch('http://localhost:3000/api/search', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({
            query: "latest tech news",
            search_recency_filter: "day"
        })
    });
    
    const data = await response.json();
    console.log(data);
}

testSearch();

🚀 部署信息

Smithery.ai 部署

可在 Smithery.ai 上進行部署，步驟如下：

1. 登錄/註冊 Smithery 賬戶。
2. 點擊“新建 MCP 服務器”。
3. 輸入 ID：traylinx-search-engine-mcp-server
4. 設置基目錄為根目錄。
5. 點擊“創建”。

❓ 故障排除

• 問題1：無法連接到 API？

  • 檢查網絡連接和 API 地址是否正確。

• 問題2：無搜索結果？

  • 確認 API 密鑰有效且配置正確。

• 日誌記錄：

  • 設置 LOG_LEVEL 為 DEBUG 可獲取詳細日誌信息。