MCP服务接口说明与接入方式-信息查询服务-阿里云

支持 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格式）

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格式）

maps mcp（地图工具）

接口	说明	输入	输出
maps_regeocode	将经纬度坐标转换为行政区划地址信息	longitude: 经度 latitude: 纬度	位置信息，包括省市区、街道等信息
maps_geo	将详细的结构化地址转换为经纬度坐标。支持对地标性名胜景区、建筑物名称解析为经纬度坐标。	address: 待解析的结构化地址信息 city: 用于限定查询范围的城市	location (位置经纬度)
maps_ip_location	根据用户输入的 IP 地址，定位 IP 的所在位置	ip: IP 地址	province (省)，city (城市)，adcode (城市编码)
maps_direction_transit_integrated	公交路径规划可以根据用户起终点经纬度坐标规划综合各类公共（火车、公交、地铁）交通方式的通勤方案，并且返回通勤方案的数据，跨城场景下必须传起点城市与终点城市	destinationCity: 目的地地点的城市名称 destinationLatitude: 目的地坐标的纬度 destinationLongitude: 目的地坐标的经度 originCity: 出发地点的城市名称 originLatitude: 出发地点坐标的纬度 originLongitude: 出发地点坐标的经度	rigin (起点信息)，destination (终点信息)，distance (规划距离)，transits (规划具体信息)
maps_bicycling	骑行路径规划 API 用于规划骑行通勤方案，规划时会考虑天桥、单行线、封路等情况。最大支持 500km 的骑行路线规划。	destinationLatitude: 目的地坐标的纬度 destinationLongitude: 目的地坐标的经度 originLatitude: 出发地点坐标的纬度 originLongitude: 出发地点坐标的经度	distance (规划距离)，duration (规划时间)，steps (规划步骤信息)
maps_direction_walking	步行路径规划 API 可以根据输入起点终点经纬度坐标规划100km 以内的步行通勤方案，并且返回通勤方案的数据	destinationLatitude: 目的地坐标的纬度 destinationLongitude: 目的地坐标的经度 originLatitude: 出发地点坐标的纬度 originLongitude: 出发地点坐标的经度	origin (起点信息)，destination (终点信息)，paths (规划具体信息)
maps_direction_driving	驾车路径规划 API 可以根据用户起终点经纬度坐标规划以小客车、轿车通勤出行的方案，并且返回通勤方案的数据。	destinationLatitude: 目的地坐标的纬度 destinationLongitude: 目的地坐标的经度 originLatitude: 出发地点坐标的纬度 originLongitude: 出发地点坐标的经度	origin (起点信息)，destination (终点信息)，paths (规划具体信息)
maps_around_search	周边搜，根据用户传入关键词以及经纬度，搜索出radius半径范围的POI	keywords: 搜索关键词，如：餐厅 latitude: 中心点纬度 longitude: 中心点经度 radius: 搜索半径，单位米，默认3000米	pois (地点信息列表)
maps_distance	距离测量 API 可以测量两个经纬度坐标之间的距离，支持驾车、步行以及球面距离测量。	destinationLatitude: 目的地坐标的纬度 destinationLongitude: 目的地坐标的经度 originLatitude: 出发地点坐标的纬度 originLongitude: 出发地点坐标的经度 type:距离测量类型, 0代表直线距离测量，1代表驾车距离测量，3步行距离测量	distanceMeter：规划距离（米） durationSecond: 耗时（秒）
maps_text_search	关键词搜，根据用户传入关键词，搜索出相关的POI	keywords: 搜索关键词 region: 查询城市 types: POI类型	pois (地点信息列表)
maps_search_detail	查询关键词搜或者周边搜获取到的POI ID的详细信息。	id: POI地址的ID	地点详情信息 location (地点经纬度)，address (地址)，business_area (商圈)，city(城市)，type (地点类型) 等

2. 接入 IQS MCP Server

通过 streamableHTTP 或 sse 接入

前往官网开通 apikey

mcp server 配置如下

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>"
      }
    }
  }
}

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>"
      }
    }
  }
}

maps mcp（地图工具）

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

通过源码自行部署

IQS mcp server 现已开源到 Github

FC 部署 MCP 服务

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