Suishenxing MCP Service

产品介绍

本项目目前支持查询坐标在上海市内的公交、地铁信息。

商务合作

1. 商务合作需求，请发送邮件至 databd@shmaas.cn 。
2. 商务合作完成后，系统会为商户配置商户id及盐值，用于请求鉴权。

发送请求

• 请求过程：连接初始化、发送业务请求
• 请求地址：https://apigtw.shmaas.net/ai-biz

连接初始化接口文档

• 请求地址: https://apigtw.shmaas.net/ai-biz/sse
• 请求方式：GET
• 返回示例：

id:ba9de9a6-2ba6-4a00-a43e-7ef941891a94
event:endpoint
data:/mcp?sessionId=ba9de9a6-2ba6-4a00-a43e-7ef941891a94

其中data:后的path及查询参数作为业务请求的path及参数，示例拼接地址：https://apigtw.shmaas.net/ai-biz/sse/mcp?sessionId=ba9de9a6-2ba6-4a00-a43e-7ef941891a94

发送业务请求接口文档

• 请求地址：与上述连接初始化接口返回的data拼接后的地址
• 请求方式：POST
• 请求参数：包含根级参数与params参数，具体如下

根级参数

params 参数

请求体组装参数示例

{
    "jsonrpc":"2.0",
    "method":"tools/call",
    "id":"e3f3b929-1",
    "params":{
        "name":"findNearByTrafficBus",
        "arguments":{
            "nearRadiusDistance":500,
            "cityCode":"310100",
            "lat":"39.9042",
            "lon":116.4074
        }
    }
}

请求头参数

参考开放平台接入网关（地址：https://open-web.shmaas.cn/docs/guide ），需将请求的arguments原始报文按如下工具排序，根据排序后的网关计算X-Sign：

package com.maas.ai.util;

import com.alibaba.fastjson2.JSON;

import java.util.*;

/**
 * Map排序工具类
 * 用于将Map中的参数按key的ASCII码排序，并递归处理嵌套的Map
 */
public class MapSortUtil {

    /**
     * 将Map中的参数按key的ASCII码排序，并递归处理嵌套的Map
     * @param params 参数Map
     * @return 排序后的JSON字符串
     */
    public static String sortAndConvertToJson(Map params) {
        Map sortedMap = sortMapByKey(params);
        return JSON.toJSONString(sortedMap);
    }

    /**
     * 递归排序Map，处理嵌套的Map和List
     * @param map 待排序的Map
     * @return 排序后的Map
     */
    @SuppressWarnings("unchecked")
    public static Map sortMapByKey(Map map) {
        if (map == null) {
            return null;
        }
        
        // 使用TreeMap按key的ASCII码自动排序
        Map sortedMap = new TreeMap<>();
        
        for (Map.Entry entry : map.entrySet()) {
            Object value = entry.getValue();
            
            if (value instanceof Map) {
                // 递归处理嵌套的Map
                sortedMap.put(entry.getKey(), sortMapByKey((Map) value));
            } else if (value instanceof List) {
                // 处理List中可能嵌套的Map
                List list = (List) value;
                List processedList = new ArrayList<>();
                for (Object item : list) {
                    if (item instanceof Map) {
                        processedList.add(sortMapByKey((Map) item));
                    } else {
                        processedList.add(item);
                    }
                }
                sortedMap.put(entry.getKey(), processedList);
            } else {
                sortedMap.put(entry.getKey(), value);
            }
        }
        
        return sortedMap;
    }
}

能力介绍

现有MCP协议功能

目前提供2款MCP协议的功能，具体信息如下：

根据经纬度及距离查询附近公交

params.name=findNearByTrafficBus

业务参数说明

请求参数

响应参数

根据经纬度及距离查询地铁信息

params.name=queryNearByMetro

业务参数说明

请求参数

响应参数

未来规划MCP服务功能

查询轨交站点进出站客流信息

请求参数

响应参数

查询停车设施运营情况

请求参数

响应参数

查询停车设施列表信息

请求参数

响应参数

核验网约车近一年月均营运行为轮廓

请求参数

响应参数

查询周边公交基本信息（按经纬度）

请求参数

响应参数

查询市域铁路班次信息

请求参数

响应参数

其他信息接口

预测信息接口

此外我们还提供了预测信息服务，接口及描述如下