首页 / Java 平台（cloud-java） / mcp AI 接入

mcp AI 接入

MCP Streamable HTTP 接入方式、工具复用与端口边界。

MCPAI
本页目录

职责概览

AI 接入模块（MCP） 独立端口 48102 / MCP 49202，基于 MCP（Model Context Protocol）Streamable HTTP 提供 AI 能力接入，让 AI Agent 复用平台既有业务能力。

模块没有独立业务 Controller，主要复用其他模块的服务能力；工具清单以 MCP Server 实现为准。

接入架构

AI Agent / 外部 LLM 应用
        │  MCP Streamable HTTP
        ▼
  entrax-module-mcp-server  (独立 Connector 端口 49202)
        │  复用 Bean / 内部调用
        ▼
  system / member / iot / subscription / prod-gps / alarm ...
  • MCP 走独立端口（entrax.mcp.server.port 实际生效值），不要与普通业务 HTTP 端口混淆。
  • 单体与独立服务形态均可用；端口由 profile 配置决定。

实现要点

  • 工具定义（tool）映射到平台能力：设备查询、告警处理、报表生成等按需暴露。
  • 工具调用复用业务 Service，权限与租户上下文按调用方身份隔离。
  • 敏感操作（支付、绑卡等）不建议直接暴露给 AI，如需暴露必须加二次确认与审计。

维护注意

  • MCP 工具清单变化会影响 AI 侧可用能力，变更需同步更新文档与 AI 提示词。
  • 排查时确认当前 profile 的 MCP 端口与工具注册日志，远程 Nacos 配置可能覆盖本地端口。