smartsearch (Cloudsway AI)

SmartSearch MCP服务器

MCP服务器集成Cloudsway智能搜索API，为MCP客户端提供网络搜索功能。

特性

• 具有分页、语言、新鲜度和网站过滤功能的网络搜索
• 适合下游处理的结构化JSON输出
• MCP兼容服务器配置和部署

工具：智能搜索

执行网络搜索并返回结构化结果。

输入参数：

• query （字符串，必填）：搜索关键字（不能为空）
• count （int，可选）：要返回的结果数。默认值：10。可接受值：10、20、30、40、50。最大值：50。
• offset （int，可选）：分页时从零开始的偏移量。默认值：0。
• setLang （字符串，可选）：结果的语言代码（建议使用4个字母的代码，如 en-US).违约： en.
• freshness （字符串，可选）：时间过滤器： Day, Week, Month，或类似的日期范围 2023-02-01..2023-05-30.
• sites （string，可选）：将结果限制到主机（例如。， github.com).

响应结构

成功响应（JSON）：

{
  "queryContext": { "originalQuery": "your search query" },
  "webPages": {
    "value": [
      {
        "name": "Page Title",
        "url": "https://example.com/page",
        "displayUrl": "https://example.com/page",
        "snippet": "Description of the page content...",
        "datePublished": "2025-07-14T00:00:00.0000000",
        "dateLastCrawled": "2025-07-15T02:48:00.0000000Z",
        "siteName": "Example Website",
        "thumbnailUrl": "https://example.com/thumbnail.jpg",
        "score": 0.95
      }
    ]
  }
}

关键字段：

• queryContext.originalQuery：提交的查询
• webPages.value[]：结果项列表 name, url, snippet, datePublished, dateLastCrawled, siteName, thumbnailUrl, score

错误处理

常见HTTP状态代码：

• 200 --成功
• 429 --超出速率限制（已达到QPS限制）

有关更高的QPS或帐户问题，请联系Cloudsway支持。

配置

获取API密钥

1. 在以下位置注册并获取端点和AccessKey：https://console.cloudsway.ai
2. 将它们合并为： {Endpoint}-{AccessKey}

环境变量

将部署环境中的组合键设置为：

export SERVER_KEY="endpoint-accesskey"

使用 SERVER_KEY 在MCP部署配置中。

部署

• 条目文件： src/smartsearch/smartsearch.py
• 确保 SERVER_KEY 环境变量被提供给正在运行的进程。

MCP服务配置示例

{
  "mcpServers": {
    "smartsearch": {
      "command": "npx",
      "args": [
        "-y",
        "@cloudsway-ai/smartsearch"
      ],
      "env": {
        "SERVER_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}