MCP服务管理

SuperMap Agentx Server深度适配 MCP 协议，支持按需添加外部MCP服务，按需启用/停用MCP服务，修改MCP服务信息，删除MCP服务。

除接入外部 MCP 服务外，平台还支持直接发布 Test2SQL 服务，将数据库自然语言问数能力封装为独立的 MCP Server，便于在智能体中统一调用与维护。

添加外部 MCP 服务

前往SuperMap AgentX Server首页，点击后台管理服务卡片下的访问，在左侧导航栏点击MCP服务管理->添加，依次填写以下内容：

  • 服务名称：填写接入的 MCP 服务名称；
  • 连接类型：选择 MCP 服务的类型，支持SSE模式；
    • SSE 模式：Server-Sent Events（SSE，服务器发送事件）是一种基于 HTTP 协议的技术，允许服务器向客户端单向、实时地推送数据，通过 URL 地址配置即可使用，地址示例：https://mcp.amap.com/sse?key=9e3a07****cdf1a21e28
  • 地址：填写服务地址，例如：http(s)://xxx/see

添加MCP服务后，需设置为启用状态，方可在智能体中调用。

如需删除MCP服务，点击该MCP服务卡片右下角的删除按钮即可。

发布 Test2SQL 服务

发布 Test2SQL 服务用于将指定数据库的自然语言转 SQL 能力发布为平台内可管理的 MCP 服务实例。每个已发布服务对应一个独立的 MCP Server，内置 text2sql 工具，接收自然语言问题并返回查询结果，可用于“智能问数”等场景。

使用场景

  • 智能问数：业务人员直接使用自然语言提问，系统自动检索相关表结构、生成SQL并执行查询，快速获取结构化业务数据，无需编写代码。

  • 多实例管理：为销售、运营、政务、资产管理等不同业务数据库分别发布独立问数服务，通过服务ID区分并统一维护，实现分业务隔离与管理。

  • 自主规划式智能体接入：在自主规划式智能体中集成数据库问数能力，使其能够自主回答结构化业务数据问题，辅助分析与决策。

  • 工作流式智能体集成：在工作流式智能体中将 Test2SQL 服务作为MCP工具节点使用，完成数据查询、分析及后续处理，无缝融入业务流程。

服务发布

以管理员身份登录 AgentX 首页，进入后台管理->MCP服务管理，点击发布服务，即可进入 Test2SQL 服务发布流程，依次填写以下配置项：

  • 服务名称：自定义服务名称，用于标识 Test2SQL 服务，建议按业务库或应用场景命名，便于在 MCP 服务列表中识别；
  • 数据库配置：数据库配置信息填写完成后，可点击连接测试，测试数据库的连通性。
    • 数据库类型：可选择 PostgreSQL 、PostGIS 数据库。
    • 服务器地址：填写数据库服务器的访问地址，格式为 IP:Port。例如：192.168.1.100:5432。请确保该地址可从当前服务环境访问。
    • 数据库名称：要连接的数据库实例名称。例如：GIS_db 。
    • Schema：数据库中的模式（Schema）名称，用于组织表、视图等对象。若不填写，将使用默认的 public 模式。根据业务需要可指定为 sales、crm 等。
    • 用户名：用于连接数据库的账号名称，该账号至少应具备目标 Schema 的查询权限。
    • 密码：对应用户名的密码。
  • 模型配置：从模型广场中选择已添加的模型。
    • 语言模型：用于将自然语言问题转换为 SQL 语句。
    • 向量模型：用于对数据库表结构信息进行向量化，并在查询时完成相关表检索。
  • 提示词配置：可按需配置规则提示词，对 SQL 生成规则、业务术语和返回风格进行约束。

填写完成后，点击完成按钮，等待数据库表结构信息向量化，当卡片显示已向量化，即完成了Test2SQL 服务的发布，以 MCP Server 的形式对外提供工具能力，地址示例： http://{ip}:{port}/agentx/text2sql/{service-id}/mcp/sse

服务管理

Test2SQL 服务发布完成后，可在 MCP 服务管理页面统一管理已发布的 Test2SQL 服务。

  • 查看服务信息：查看服务名称、数据库信息、模型配置信息与向量化状态；
  • 编辑服务信息：按需调整模型配置、提示词配置；
  • 刷新数据库：当数据库表结构发生变化时，可触发刷新操作，重新生成表向量；
  • 启用/停用服务：控制该服务是否可在智能体侧调用；
  • 删除服务：按需删除服务。

在智能体中使用 MCP 服务

  • 在自主规划式智能体中，点击设置->MCP管理->导入服务，即可看到按上述步骤添加的外部MCP服务，以及已发布并启用的 Test2SQL 服务，选择导入后即可在自主规划式智能体中使用。
  • 在工作流式智能体可视化搭建中，拖拽MCP工具组件到画布中，点击选择服务，即可看到按上述步骤添加的外部MCP服务，以及已发布并启用的 Test2SQL 服务，选择后即可在工作流智能体搭建中使用。