Traylinx Search Engine MCP Server

🚀 Traylinx 搜索引擎 MCP 服务器

Traylinx 搜索引擎 MCP 服务器是一个模型上下文协议（MCP）服务器，作为部署的 Agentic 搜索 API 的桥梁。它能让 Claude Desktop 和 Cursor 这类 MCP 客户端使用智能搜索功能，还能提供详细的文本摘要和结构化数据（如 HTML、图像等）。

🚀 快速开始

通过以下步骤，你可以快速开启使用 Traylinx 搜索引擎 MCP 服务器的旅程：

1. 安装配置：按照安装步骤和配置指南完成服务器的安装与配置。
2. 验证测试：使用验证方法对服务器进行测试，确保其正常工作。
3. 开始使用：根据需求使用 search 工具执行搜索。

✨ 主要特性

• 智能搜索：借助 Agentic 搜索 API 执行网络搜索，提供详细且上下文相关的结果并附有引用。
• 多内容类型支持：支持返回文本摘要、结构化数据和新闻文章等多种内容类型。
• 时间过滤：可按时间筛选搜索结果，如 "month"、"week"、"day"、"hour"。

📦 安装指南

1. 项目介绍：Traylinx 搜索引擎 MCP 服务器是连接 MCP 客户端与 Agentic 搜索 API 的桥梁。
2. 工具说明：search 工具允许从 MCP 客户端执行网络搜索，并返回详细结果。
3. 工作流程：
   • 接收搜索查询。
   • 调用 Agentic 搜索 API。
   • 处理并格式化响应，供 MCP 客户端使用。

💻 使用示例

基础用法

// 调用 search 工具进行搜索
{
  "name": "search",
  "arguments": {
    "query": "latest tech news"
  }
}

高级用法

// 使用时间过滤器进行搜索
{
  "name": "search",
  "arguments": {
    "query": "SpaceX 发射",
    "search_recency_filter": "week"
  }
}

📚 详细文档

工具

search

使用 Traylinx 的 API 执行网络搜索，该 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"
  }
}

验证方法

手动测试

运行以下命令以验证服务器是否正常工作：

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();

高级使用案例

多内容类型返回

服务器支持以下内容类型：

• 文本摘要：简洁的搜索结果。
• 结构化数据：URL、标题和描述。
• 新闻文章：带时间戳和缩略图的文章。

部署信息

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 获取详细日志信息。

🔧 技术细节

1. 项目介绍：Traylinx 搜索引擎 MCP 服务器是一个桥梁，连接 MCP 客户端与 Agentic 搜索 API。
2. 工具说明：search 工具允许从 MCP 客户端执行网络搜索，并返回详细结果。
3. 工作流程：
   • 接收搜索查询。
   • 调用 Agentic 搜索 API。
   • 处理并格式化响应，供 MCP 客户端使用。

📄 许可证

该项目使用 MIT 许可证，详情请参阅 LICENSE 文件。