接入搜索 MCP Server

更新时间:
复制为 MD 格式

支持 MCP 协议的客户端(如:Cursor、Claude、Cline)可方便使用搜索 MCP server。目前仅支持 Node.js I/O 接入方式。本篇文章介绍如何两种接入方式:1. 通过 streamableHTTP 或 sse 接入 IQS mcp server;2. 通过源码自行部署 IQS mcp server;

1. MCP Server 接口说明

search mcp(搜索工具)

接口

说明

输入

输出

common_search

标准搜索接口提供增强的网络开放域的实时搜索能力,通过大模型优化与多数据源融合的技术,查询干净、准确、多样、高质量的结果。

query: 搜索问题(长度:>=2 and <=500)

搜索结果(markdown格式)

lite search mcp(轻量版搜索工具)

接口

说明

输入

输出

web_search

web_search 接口提供增强的网络开放域的实时搜索能力,通过大模型优化与多数据源融合的技术,查询干净、准确、多样、高质量的结果。

query: 搜索问题(长度:>=2 and <=500)

搜索结果(markdown格式)

readpage mcp(网页解析工具)

接口

说明

输入

输出

readpage_basic

readpage_basic 接口提供静态网页解析能力,用于获取目标 url 的网页内容。

**补充说明:**

- 若 readpage_basic 获取内容较少时,尝试使用 readpage_scrape 可获取更多内容。

**使用示例:**

```json

{

"name": "readpage_basic", "arguments": { "url": "" }

}

```

url: 需要解析的网页 URL(必须是完整的 URL,格式如:https://www.example.com)

页面内容(markdown格式)

readpage_scrape

readpage_scrape 接口通过 headless browser 提供网页解析能力,用于获取目标 url 的网页内容。

**使用示例:**

```json

{

"name": "readpage_scrape","arguments": { "url": "" }

}

```

url: 需要解析的网页 URL(必须是完整的 URL,格式如:https://www.example.com)

页面内容(markdown格式)

2. 接入 IQS MCP Server

通过 streamableHTTP 或 sse 接入

  1. 前往官网开通 apikey

  2. mcp server 配置如下

    1. search mcp(搜索工具)

      {
        "mcpServers": {
          "iqs-mcp-server-maps": {
            "type": "streamableHttp",
            "url": "https://iqs-mcp.aliyuncs.com/mcp-servers/iqs-mcp-server-search",
            "headers": {
              "X-API-Key": "<X-API-Key>"
            }
          }
        }
      }
      {
        "mcpServers": {
          "iqs-mcp-server-maps": {
            "type": "sse",
            "url": "https://iqs-mcp.aliyuncs.com/mcp-servers/iqs-mcp-server-search/sse",
            "headers": {
              "X-API-Key": "<X-API-Key>"
            }
          }
        }
      }

    2. lite search mcp(轻量版搜索工具)

      {
        "mcpServers": {
          "iqs-mcp-server-maps": {
            "type": "streamableHttp",
            "url": "https://iqs-mcp.aliyuncs.com/mcp-servers/iqs-mcp-server-litesearch",
            "headers": {
              "X-API-Key": "<X-API-Key>"
            }
          }
        }
      }
      {
        "mcpServers": {
          "iqs-mcp-server-maps": {
            "type": "sse",
            "url": "https://iqs-mcp.aliyuncs.com/mcp-servers/iqs-mcp-server-litesearch/sse",
            "headers": {
              "X-API-Key": "<X-API-Key>"
            }
          }
        }
      }
  3. readpage mcp(网页解析工具)

    {
      "mcpServers": {
        "iqs-mcp-server-maps": {
          "type": "streamableHttp",
          "url": "https://iqs-mcp.aliyuncs.com/mcp-servers/iqs-mcp-server-readpage",
          "headers": {
            "X-API-Key": "<X-API-Key>"
          }
        }
      }
    }
    {
      "mcpServers": {
        "iqs-mcp-server-maps": {
          "type": "sse",
          "url": "https://iqs-mcp.aliyuncs.com/mcp-servers/iqs-mcp-server-readpage/sse",
          "headers": {
            "X-API-Key": "<X-API-Key>"
          }
        }
      }
    }

3. 接入工具

OpenClaw

  1. 在终端执行如下命令安装 MCPorter。

npm install -g mcporter

  1. 在终端执行如下命令,启用 MCPorter。

openclaw config set skills.entries.mcporter.enabled true

  1. ~/.openclaw/workspace目录下,执行如下命令。

mcporter config add WebSearch https://iqs-mcp.aliyuncs.com/mcp-servers/iqs-mcp-server-search --transport http --header "Authorization=Bearer YOUR_API_KEY"

  1. ~/.openclaw/workspace目录下,执行如下命令确认MCP已安装。

mcporter list

  1. 在终端执行如下命令使配置生效。

openclaw gateway restart

  1. 发送提问使用 mcporter 搜索阿里云即可看到搜索结果。

image

Claude Code

  1. 执行如下命令,添加 MCP。

claude mcp add WebSearch https://iqs-mcp.aliyuncs.com/mcp-servers/iqs-mcp-server-search -t http -H "Authorization: Bearer YOUR_API_KEY"

  1. 验证配置效果

image

Qwen Code

  1. 执行如下命令,添加 MCP。

qodercli mcp add WebSearch https://iqs-mcp.aliyuncs.com/mcp-servers/iqs-mcp-server-search -t http -H "Authorization: Bearer YOUR_API_KEY"

  1. 验证配置效果

image

image

FC

前往云原生应用开发平台 CAP 一键部署 iqs-mcp-server。