概述
MSE Nacos 企业版支持MCP(Model Context Protocol,模型上下文协议)服务的注册与配置管理。MCP是一种开放标准,旨在统一大型语言模型(LLM)与外部数据源和工具之间的通信协议,解决当前 AI 模型数据孤岛限制,使得 AI 应用能够安全地访问和操作本地及远程数据。
说明
目前只有 MSE Nacos企业版3.0及以上版本支持MCP服务。您可以根据业务需求的不同,选择微服务引擎注册配置中心提供的三种MCP服务创建方式:
标准MCP服务:从零构建完整MCP配置。
HTTP转化MCP服务:将存量HTTP服务转换为MCP服务。
动态注册MCP服务:通过Nacos SDK实现服务自动注册。
创建MCP服务
在微服务引擎MSE注册配置中心管理控制台可以创建标准MCP服务和HTTP转化MCP服务,下面分别说明创建操作步骤:
创建标准MCP服务
登录微服务引擎 MSE注册配置中心管理控制台,选择实例所在的资源池。
在左侧导航栏,选择注册配置中心 > 实例列表,选择企业版Nacos实例,单击实例ID 或者管理按钮跳转至基础信息页面。
在基础信息页面,左侧菜单点击MCP管理 > MCP列表,选择命名空间, 然后单击创建MCP服务,并单击标准MCP服务页签。
在标准MCP服务页面,配置服务名称、描述、版本号等基本信息,其中重要参数说明如下:
MCP协议类型:
Stdio:无网络依赖,只能访问本地资源无法访问云端资源,数据不会传输到外部,适用于本地开发调试,离线环境验证。
SSE:支持远程访问,仅支持服务端到客户端的单向流,适用于服务推送等单向实时通信场景,延迟低、兼容性强。
Streamable HTTP:基于标准的HTTP协议,双向通信,可灵活切换流式、非流式连接,适合正式环境部署和跨网络通信(如混合云/跨VPC)以及分布式系统。这是目前官方推荐的远程通信方式。
后端服务:
使用已有服务:如果您的MCP服务已经通过控制台或SDK注册到MSE Nacos中,可直接选择。
新建服务:如果您的MCP服务尚未注册到MSE Nacos中,需要配置服务 IP/服务域名(域名不能包含中文)、服务端口及访问路径(必须以/开头,如/v1/mcp)。
MCP工具为选填项,工具可以包含0个或者多个。点击添加工具按钮,可以添加1个工具,包括工具名称、工具描述、参数信息。其中参数包括:参数名称、参数类型可从下拉框选择,参数描述信息。
参数可以添加0个或者多个,参数信息可以嵌套,可以实现复杂的嵌套参数。添加的参数在服务保存或发布后生效。
信息填写完毕后,点击发布。
创建HTTP转化MCP服务
登录微服务引擎 MSE注册配置中心管理控制台,选择资源池。
在左侧导航栏,选择注册配置中心 > 实例列表,选择企业版Nacos实例,单击实例ID 或者管理按钮跳转至基础信息页面。
在基础信息页面,左侧菜单点击MCP管理 > MCP列表,选择命名空间, 然后单击创建MCP服务,并单击HTTP转化MCP服务页签。
在HTTP转化MCP服务页面,配置服务名称、描述、版本号等基本信息,其中重要参数说明如下:
MCP协议类型:
SSE:支持远程访问,仅支持服务端到客户端的单向流,适用于服务推送等单向实时通信场景,延迟低、兼容性强。
Streamable HTTP:基于标准的HTTP协议,双向通信,可灵活切换流式、非流式连接,适合正式环境部署和跨网络通信(如混合云/跨VPC)以及分布式系统。这是目前官方推荐的远程通信方式。
后端服务:
使用已有服务:如果您的HTTP服务已经通过控制台或SDK注册到MSE Nacos中,可直接选择。
新建服务:如果您的MCP服务尚未注册到MSE Nacos中,需要配置服务 IP/服务域名(域名不能包含中文)、服务端口。
MCP工具为选填项,工具可以包含0个或者多个。点击添加工具按钮,可以添加1个工具,包括工具名称、工具描述、参数信息。其中参数包括:参数名称、参数类型可从下拉框选择,参数描述信息。参数可以添加0个或者多个,参数信息可以嵌套,可以实现复杂的嵌套参数。添加的参数在服务保存或发布后生效。
信息填写完毕后,点击发布并保存。
查看MCP服务详情
登录微服务引擎 MSE注册配置中心管理控制台,选择资源池。
在左侧导航栏,选择注册配置中心 > 实例列表,选择企业版Nacos实例,单击实例ID 或者管理按钮跳转至基础信息页面。
在基础信息页面,左侧菜单点击MCP管理 > MCP列表,选择命名空间, 然后单击MCP服务名称或者对应行的查看按钮跳转到服务详情页面。
默认情况下跳转到详情页面查看的是当前发布版本的服务详情。如果需要查看其他版本,可以从详情页面左上方下拉列表选择需要编辑的版本号,详情页面会更新到对应的版本的详细信息。
在服务详情页面可以查看当前版本的工具,并且可以点击工具项前方的开关来启用或者禁用工具。
编辑MCP服务
登录微服务引擎 MSE注册配置中心管理控制台,选择资源池。
在左侧导航栏,选择注册配置中心 > 实例列表,选择企业版Nacos实例,单击实例ID或者管理按钮跳转至基础信息页面。
在基础信息页面,左侧菜单点击MCP管理 > MCP列表,选择命名空间, 然后单击MCP服务名称或者对应行的查看按钮跳转到服务详情页面。在列表页点击编辑按钮,默认编辑当前发布的版本。
默认情况下跳转到详情页面查看的是当前发布版本的服务详情。如果需要查看其他版本,可以从详情页面左上方下拉列表选择需要编辑的版本号,详情页面会更新到对应的版本的详细信息。
点击编辑按钮即可进入编辑页面,修改对应版本的服务。
MCP工具的工具描述与参数结构中的描述,无需变更版本号,可以直接编辑保存;
如果您需要修改服务或者工具的其他属性,需要先更新版本号之后再执行修改。
说明
每个MCP服务每个版本只保存一个草稿,即最新保存的且不发布的版本。
删除MCP服务
登录微服务引擎 MSE注册配置中心管理控制台,选择资源池。
在左侧导航栏,选择注册配置中心 > 实例列表,选择企业版Nacos实例,单击实例ID 或者管理按钮跳转至基础信息页面。
在基础信息页面,左侧菜单点击MCP管理 > MCP列表,选择命名空间。
选择目标项服务,点击对应操作列中的删除按钮,即可删除MCP服务。
禁用MCP服务
登录微服务引擎 MSE注册配置中心管理控制台,选择资源池。
在左侧导航栏,选择注册配置中心 > 实例列表,选择企业版Nacos实例,单击实例ID 或者管理按钮跳转至基础信息页面。
在基础信息页面,左侧菜单点击MCP管理 > MCP列表,选择命名空间。
选择目标项服务,点击对应操作列中的禁用按钮,即可禁用MCP服务。
创建/编辑/删除MCP工具
说明
MCP工具是MCP服务的可选的一部分,工具需要依托MCP服务存在,而不能脱离服务单独存在。所有下面描述中的创建/编辑/删除MCP工具均依托于MCP服务。
登录微服务引擎 MSE注册配置中心管理控制台,选择资源池。
在左侧导航栏,选择注册配置中心 > 实例列表,选择企业版Nacos实例,单击实例ID 或者管理按钮跳转至基础信息页面。
在基础信息页面,左侧菜单点击MCP管理 > MCP列表,选择命名空间, 然后单击创建服务或者修改服务。
创建服务: 创建服务时可以新增MCP 工具,属性包括 工具名称、工具描述、参数名称、参数类型、参数描述等信息。
编辑服务:
不修改服务版本号时,只能修改工具描述和参数描述。
修改服务版本号时,可以新增工具,可以修改工具描述、参数名称、参数类型、参数描述等信息,可以删除工具。
修改工具后需要点击服务的保存或保存并发布按钮将修改提交成功后才能生效。