中枢 MCP API 参考手册

款多多即时零售运营分析平台 · 统一能力入口 · 13域93数据工具 + 能力网关9工具

V2.2 · 2026-08-19
93
MCP 数据工具
9
能力网关工具
13
分析域
Streamable HTTP
协议
接入认证(V7.0.4):统一网关 https://aimo.kddauto.com/mcp/gateway 采用 default-deny 认证。 所有公网调用必须携带 X-Gateway-Key 请求头(dgk_ 本地 Key 或 tk-ai- 天枢统一 Key), 无 Key 返回 401,Key 无效返回 403。详细接入指南见 docs/中枢统一数据网关/06_MCP全流程架构与外部AI接入指南_V7.0.4.md

快速开始

端点信息

MCP 端点https://aimo.kddauto.com/mcp/gateway
说明网页https://aimo.kddauto.com/mcp(GET 文档页,非协议端点)
健康检查6009 根路径 GET(/mcp/gateway 返回版本/工具数/口径声明)
协议MCP Streamable HTTP (SSE)
认证方式天枢统一Key(tk-ai-*)或中枢本地Key(dgk_*),通过 X-Gateway-Key 请求头发送
Key获取统一Key由天枢签发(一套Key通四个系统),详见 天枢MCP接入页
数据保护只读模式 · 品牌级隔离 · SQL注入拦截

快速验证

# 查看服务状态(GET请求,返回JSON)
curl -s https://aimo.kddauto.com/mcp | python3 -m json.tool

# 预期响应(截取)
{
  "code": 0,
  "data": {
    "tools": 85,
    "version": "10.0.0-p2",
    "domains": ["dashboard","report","store","product","user","order","ai","system","fulfillment","promotion","inventory","advanced_ai","insight"],
    "supply_chain": "库存/履约/补货/物流独立统计(services/supply_chain 独立模块,不混入零售口径)",
    "retail_scope": "订单/营收/门店/用户/商品/渠道/品牌(v_fact_order_detail_retail 零售核心口径)"
  }
}

# MCP客户端连接方式(Streamable HTTP协议)
# 端点: https://aimo.kddauto.com/mcp/gateway (POST JSON-RPC,必带Accept: application/json, text/event-stream)
# 协议: MCP Streamable HTTP (SSE)
# 认证: X-Gateway-Key 请求头(tk-ai-* 天枢统一Key 或 dgk_* 中枢本地Key)
# 示例: curl -X POST https://aimo.kddauto.com/mcp/gateway -H "Content-Type: application/json" \
#   -H "Accept: application/json, text/event-stream" -H "X-Gateway-Key: tk-ai-xxx" \
#   -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}'
# 注意: /mcp 为说明文档页(GET),协议端点统一使用 /mcp/gateway

⚙️ 业务口径边界V2.1

长庚总铁律:全栈零售/供应链数据分离。中枢 MCP 所有业务分析工具统一使用零售口径,供应链业务独立模块与独立存储,互不混杂。

口径 数据源 覆盖工具域 说明
零售核心 v_fact_order_detail_retail dashboard/report/store/product/user/order/ai/fulfillment/promotion/inventory 即时零售唯一口径(order_type='retail'),订单/营收/门店/用户/商品/渠道/品牌
供应链独立 services/supply_chain + /api/v1/supply-chain 库存/履约/补货/物流 6端点独立统计 数据独立存储(meituan_data.mv_store_sku_inventory 等),不混入零售,前端 /supply-chain 独立导航
系统核验 fact_order_detail 全量 system_data_integrity 仅系统健康检查(含供应链/礼品),不参与业务分析

📈 仪表盘10 工具

dashboard_overview
营收总览 KPI:GMV/订单量/用户数/客单价/门店数
参数: brand_id 可选 · days 默认30 · channel 可选
dashboard_revenue_trend
营收日趋势:逐日GMV和订单量变化,支持同比对比
参数: brand_id 可选 · days 默认30 · channel 可选
dashboard_revenue_comparison
同比环比对比:本期 vs 上期 vs 去年同期的GMV/订单/客单价
参数: brand_id 可选 · days 默认30
dashboard_channel_comparison
渠道对比:各渠道(美团/京东/抖音等)GMV/订单/客单价
参数: brand_id 可选 · days 默认90
dashboard_category_revenue
品类营收分布:各品类GMV占比和排名
参数: brand_id 可选 · days 默认90
dashboard_top_products
热销排行:TOP N商品的销量和营收排名
参数: brand_id 可选 · limit 默认20
dashboard_city_performance
城市表现:各城市GMV/订单/门店分布
参数: brand_id 可选 · days 默认90
dashboard_kpi_detail
KPI钻取:核心指标明细和同比环比变化
参数: brand_id 可选
dashboard_sparkline
Sparkline趋势:紧凑型营收/订单日趋势数据
参数: brand_id 可选 · days 默认30
dashboard_geo_distribution
地理分布:品牌/门店在全国的地图可视化数据
参数: brand_id 可选

📄 报告9 工具

report_brand_daily
品牌日报:单品牌某日或近7天全维度日报
参数: brand_id 必填 · date_str 可选
report_weekly
品牌周报:7天趋势+渠道/品类/门店汇总
参数: brand_id 可选
report_history
报告历史:已生成的报告列表和下载链接
参数: brand_id 可选 · limit 默认20
report_data_story
数据故事:将数据转化为自然语言叙述
参数: brand_id 必填 · days 默认30
report_brand_kpi
品牌KPI:多品牌对比的核心KPI快照
参数: brand_id 必填
report_executive_summaryP1
高管摘要:300字核心KPI+预警+建议,管理层快速决策
参数: brand_id 必填 · days 默认30
report_event_reviewP1
事件复盘:大促/活动期 vs 基线期的对比分析
参数: brand_id 必填 · event_start · event_end
report_strategic_reviewP1
战略回顾:季度营收目标达成率+差距分析+增长引擎诊断
参数: brand_id 必填 · quarter 可选
report_auto_insightP1
自动洞察:AI自动发现数据亮点/异常/趋势
参数: brand_id 必填 · days 默认30

🏠 门店11 工具

store_analysis
门店分析:各门店销售数据排行(营收/订单/客户/客单价)
参数: brand_id 可选 · limit 默认20
store_map_markers
门店地图坐标:有经纬度的门店列表
参数: brand_id 可选
store_list
门店列表:所有门店基本信息
参数: brand_id 可选 · limit 默认50
store_assortment
门店选品分析:各门店SKU数/销量/营收结构
参数: brand_id 必填 · limit 默认20
store_health_scoreP1
门店健康度:营收/效率/动销/履约四维加权评分(S/A/B/C)
参数: brand_id 可选 · store_id 可选
store_new_rampP1
新店爬坡分析:开业后逐月业绩增长曲线 vs 行业基准
参数: brand_id 可选 · months 默认12
store_comparisonP1
多店对比:营收/订单/客单价/动销率/复购率雷达对比
参数: store_ids 必填(逗号分隔)
store_o2o_penetrationP1
O2O渗透率:各渠道线上销售占比和客单价对比
参数: brand_id 可选 · days 默认90
store_business_dataV8.2.0
门店经营数据(MO中台权威实时):单店26项经营KPI(销售额/订单/客单/毛利/转化/曝光/库存/连带/在架/扣点/推广等,含目标/达成率/环比)
参数: store_idstore_name 必填 · start_date/end_date 默认近30天 · brand_id 可选
store_business_compareV8.2.0
多门店经营数据对比(MO中台权威实时):逐店返回完整KPI横向比较
参数: store_idsstore_names 逗号分隔(≤20家) · start_date/end_date · brand_id 可选
store_snapshot_historyV8.3.0
门店经营快照历史(MO中台权威按日快照):每日经营数据历史,支撑趋势分析,不占实时API配额
参数: store_idstore_name 必填 · start_date/end_date 默认近30天 · limit 默认50

📦 商品7 工具

product_ranking
爆旺平滞分级:40%销量+60%营收复合权重-爆品/旺品/平品/滞品
参数: brand_id 可选
product_price_bands
价格带分析:各价格段SKU/销量/营收分布
参数: brand_id 可选
product_category_list
品类列表:所有在售品类分类
product_basket_analysisP1
购物篮关联:支持度/置信度/提升度-发现商品关联规则
参数: brand_id 可选 · min_support 默认0.01 · top_n 默认20
product_abc_classificationP1
ABC商品分层:A(20%SKU/80%营收) B(30%/15%) C(50%/5%)
参数: brand_id 可选
product_lifecycleP1
生命周期:引入期/成长期/成熟期/衰退期识别
参数: brand_id 可选
product_price_elasticityP1
价格弹性:各品类价格变化对销量的影响系数
参数: brand_id 可选

👥 用户8 工具

user_analysis
用户总览:总用户/客单价/总订单
参数: brand_id 可选
user_repurchase
复购分析:用户购买频次分布(1次/2-3次/4-6次/7次+)
参数: brand_id 可选
user_retention
留存概览:各月新增用户队列留存
参数: brand_id 可选
user_rfmP1
RFM分层:R(最近)/F(频次)/M(金额) 8类人群精准画像
参数: brand_id 可选
user_aipP1
AIPL资产:认知→兴趣→购买→忠诚四层漏斗和流转率
参数: brand_id 可选
user_churn_warningP1
流失预警:近N天未购买高价值用户+流失趋势
参数: brand_id 可选 · inactive_days 默认30
user_conversion_funnelP1
转化漏斗:1次→2次→3次→5次→10次+ 层级转化率
参数: brand_id 可选 · days 默认90
user_cohort_retentionP1
同期群留存:按月队列的首单用户后续月留存率矩阵
参数: brand_id 可选 · months 默认6

💳 订单5 工具

order_summary
订单汇总:总订单/总营收/总用户/总门店
参数: brand_id 可选 · days 默认90
order_channels
订单渠道分布:各渠道订单量和营收占比
参数: brand_id 可选
order_data_availability
数据可用性:检查各品牌/渠道最新数据日期
order_detail
订单详情:单订单的完整商品/金额/用户信息
参数: order_sn 必填
mo_sync_status
MO同步状态:MO平台数据同步进度和最近一次同步时间

🤖 AI 分析12 工具

ai_anomaly_detect
异常检测:自动扫描营收/订单/用户异常波动
参数: brand_id 可选
ai_attribute_analysisP0
多维归因:渠道×品类×商品×门店×用户 五维加权拆解
参数: brand_id 必填 · metric 默认revenue · days 默认30
ai_predictV7.2.0
AI预测:多模型需求预测引擎(LightGBM/SARIMA/Naive自动选优),品牌级日营收预测,实证wMAPE 22.4%
参数: brand_id 可选 · REST: POST /api/v1/forecast/predict
ai_llm_health
LLM健康:AI推理引擎的运行状态和响应时间
ai_llm_breaker
LLM熔断器:AI调用限流和异常熔断状态
ai_quota_status
用量状态:Token/调用次数配额使用量和剩余量
ai_quality_monitor
质量监控:AI输出质量评分和趋势
参数: brand_id 可选
ai_natural_queryP1
ChatBI:中文自然语言→SQL→执行→解释(支持营收/渠道/品类/门店查询)
参数: brand_id 必填 · question 必填
algorithm_recommend_topnV8.1.0
智能选品推荐:基于销量/营收/动销综合评分推荐TopN商品
参数: brand_id 可选 · top_n 默认20
algorithm_pricing_suggestV8.1.0
动态定价建议:基于价格弹性/竞品/毛利目标输出调价建议
参数: brand_id 可选 · product_name 可选
algorithm_replenish_forecastV8.1.0
智能补货预测:门店×SKU级补货建议(安全库存/补货点/建议量,P0-P3优先级)
参数: brand_id 必填 · store_id 可选
algorithm_rag_queryV8.1.0
业务知识问答:检索款多多业务知识库并给出带来源的回答
参数: question 必填

系统12 工具

system_health
系统健康:所有服务的运行状态/响应时间/错误率
system_brand_list
品牌列表:所有品牌的ID/名称/品类/状态
system_channel_list
渠道列表:所有销售渠道及编码
system_dimensions
维度库:系统支持的所有分析维度和指标定义
system_templates
模板市场:报告/分析模板列表和元数据
system_daily_intel
每日情报:当日行业动态和品牌运营情报
system_evolution
进化史记:系统迭代历史和关键变更记录
system_data_integrity
数据完整性:5维核验(总量/增量/分布/空值/连续性)+健康评分
system_kddwiki_search
知识搜索:款多多知识图谱(品牌/产品/运营知识)
system_operation_stats
运营统计:系统调用量/活跃品牌/高频工具统计
system_scheduler_status
调度状态:定时任务(数据同步/报告生成/告警扫描)的运行状态
system_store_count
门店统计:按品牌/渠道/城市的门店数量分布

🚚 履约5 工具P0

fulfillment_overviewP0
履约总览:30分钟达率/平均配送时长/超时率/取消率
参数: brand_id 可选 · days 默认30
fulfillment_trendP0
履约趋势:每日配送时长/超时率/取消率日度波动
参数: brand_id 可选 · days 默认30
fulfillment_store_rankingP0
门店履约排行:按配送时效/超时率/取消率三维排名
参数: brand_id 可选 · limit 默认20
fulfillment_oos_analysisP0
缺货分析:缺货率趋势+高频缺货商品+损失营收评估
参数: brand_id 可选 · days 默认30
fulfillment_hourly_patternP0
分时段效率:各小时段订单量+履约时效分布
参数: brand_id 可选

🎉 促销5 工具P0

promotion_overviewP0
促销总览:活动数/总投入/增量GMV/ROI
参数: brand_id 可选 · days 默认90
promotion_roi_detailP0
ROI明细:逐日促销投入产出分析(ROI=增量GMV/投入)
参数: brand_id 可选 · days 默认90
promotion_coupon_analysisP0
优惠券分析:发放量/核销率/复购率(基于operation_logs近似)
参数: brand_id 可选 · days 默认90
promotion_channel_effectP0
渠道效果:各渠道促销订单/GMV/估算ROI对比
参数: brand_id 可选 · days 默认90
promotion_category_sensitivityP0
品类敏感度:各品类促销弹性(高/中/低/不敏感)
参数: brand_id 可选 · days 默认90

🗃 库存4 工具P0

inventory_turnoverP0
周转分析:日均销量/在售天数/估算周转天数(标杆<15天)
参数: brand_id 可选 · days 默认90
inventory_abc_classificationP0
ABC分类:A(20%SKU/80%营收) B(30%/15%) C(50%/5%)
参数: brand_id 可选
inventory_slow_movingP0
滞销品:近N天无销售SKU,按距最后销售天数排序
参数: brand_id 可选 · days_no_sale 默认30
inventory_health_scoreP0
健康度评分:动销率/滞销率/ABC健康/周转效率加权(百分制)
参数: brand_id 可选

🔍 洞察5 工具P2

ai_strategy_recommendP2
策略推荐:7维度扫描→≥5条优化建议+优先级评分(0-100)
参数: brand_id 必填
ai_competitor_benchmarkP2
竞品对标:7指标分位值(TOP25%/中位/末25%)+差距分析
参数: brand_id 必填
insight_industry_trendP2
行业趋势:月度趋势/品类增长TOP15/渠道份额迁移
参数: brand_id 可选 · months 默认12
insight_best_practiceP2
最佳实践:8大场景知识库+工具链+Prompt模板(营收/渠道/复购/促销/门店/履约/新品/竞品)
参数: scenario 可选(留空返回全部场景列表)
ai_decision_logV7.1.0
决策日志:算法决策(预测/选品/定价/补货)写入决策日志库,可审计可回溯
参数: algorithm 必填(forecast/replenish/pricing/selection/demand/health) · decision_type 必填(predict/price/replenish/select/evaluate) · brand_id 可选 · output_summary 可选 · confidence 可选

🔧 能力网关9 工具

能力网关(8895):文件/命令/搜索等通用能力,与数据工具互补。端点 https://aimo.kddauto.com/api/v1/capability-gateway/{path}, AI 通过 MCP 网关统一调用,携带 X-API-Keykdd_)或天枢统一 Key。
capability__file_read
读取服务器文件内容(文本文件)
参数: path 必填
capability__file_write
写入文件(覆盖写入)
参数: path 必填 · content 必填
capability__file_replace
精确替换文件内容片段(安全编辑)
参数: path 必填 · old_string 必填 · new_string 必填
capability__list_dir
列出目录内容
参数: path 必填
capability__search_content
文件内容搜索(正则)
参数: pattern 必填 · path 可选
capability__search_file
文件名通配搜索
参数: pattern 必填
capability__execute_command
执行服务器命令(仅允许白名单命令)
参数: command 必填 · timeout 默认30
capability__web_fetch
抓取网页并提取正文内容
参数: url 必填
capability__web_search
互联网搜索(返回标题/摘要/链接)
参数: query 必填