更新时间:2025-08-22 GMT+08:00
分享

创建MCP服务

平台资产中心提供多种MCP资源,用户通过简单安装即可快速集成调用。同时,平台支持灵活拓展,兼容开源社区MCP及自主开发MCP服务的接入。在Agent开发中集成MCP服务,可显著提升工具调用能力。

前提条件

  • 如果需要接入自主开发的MCP服务,需确保该服务已完成独立部署。
  • 需要具备AI原生应用引擎管理员或开发者权限,权限申请操作请参考AppStage组织成员申请权限

平台预置的MCP介绍

您可以在AI原生应用引擎的左侧导航栏选择“资产中心”,选择“MCP”页签,查看平台预置的MCP资源,如图1所示。

在各MCP卡片上,可直观查看MCP的评分、阅读量及安装量。

单击卡片,在“MCP详情”页面可以查看MCP的详细信息,包括服务描述、服务介绍、功能、安装信息、配置信息、配置示例及许可证等;在“服务描述”区域单击“我来评分”即可对MCP服务进行评分;在“MCP详情”页面的“热门使用推荐”区域,可查看热门MCP服务。

图1 资产中心MCP

创建MCP服务

  1. 进入AI原生应用引擎
  2. 在AI原生应用引擎的左侧导航栏选择“Agent编排中心 > 我的MCP”,单击“创建MCP服务”。
  3. 在弹框中选择空白模板或平台预置的MCP,单击“下一步”

    对于资产中心预置的MCP,您也可以通过如下方式进入服务创建页面:在AI原生应用引擎的左侧导航栏选择“资产中心”,选择“MCP”页签,将鼠标光标移至MCP卡片上,单击“安装”
    • 空白模板:适用于安装开源社区的MCP或接入自主开发的MCP服务。
    • 平台预置MCP:适用于安装平台预置的MCP。

  4. 配置MCP服务,参数说明如表1所示。

    表1 创建MCP服务参数说明

    参数名称

    参数说明

    服务名称

    MCP服务名称,支持中英文、数字、中划线(-)、下划线(_),长度2-64个字符,仅支持以中英文开头。

    服务名称用于区分多个MCP服务,不会对大模型的判断和调用产生影响。

    服务描述

    MCP服务的描述信息。例如,一个强大的MCP服务器,可以轻松地将网页内容抓取并转换为各种格式(HTML、JSON、Markdown、纯文本)。

    服务描述不会对大模型的判断和调用产生影响。

    安装方式

    • NPX:当MCP基于Node.js开发时选择NPX方式。
    • UVX:当MCP基于Python开发时选择UVX方式。
    • SSE:适用于与已部署在外部环境的远程MCP服务器建立连接,例如,接入自主开发的MCP服务。

    输入MCP服务配置

    支持使用表单编辑或使用JSON格式编辑。

    • 使用JSON格式编辑

      使用JSON格式编辑时,将明文显示加密变量值,加密变量以_encrypt_开头,请谨慎操作。

      • 安装平台预置的MCP时,默认展示当前MCP的服务配置,一般无需修改,部分服务需要填写API Key,请登录该MCP服务的官网获取。

        例如,百度地图的服务配置如下,“BAIDU_MAP_API_KEY”需要登录百度地图官网获取。

        {
            "mcpServers": {
                "baidu-map": {
                    "command": "npx",
                    "args": [
                        "-y",
                        "@baidumap/mcp-server-baidu-map"
                    ],
                    "env": {
                        "BAIDU_MAP_API_KEY": "xxx"
                    }
                }
            }
        }
      • 如果部署开源社区的MCP,请在开源社区该MCP服务详情页获取配置代码。
      • 如果接入自主开发的MCP服务,服务配置模板如下,请将“url”更换为该MCP服务的实际部署地址。
        {
            "mcpServers": {
                "example-sse": {
                    "url": "https://example.com?key=<您在服务官网上申请的key>"
                }
            }
        }
    • 使用表单编辑
      • 参数值:填写参数值,多个参数值之间使用英文逗号分隔。例如,-y,@baidumap/mcp-server-baidu-map。
      • 环境变量:单击“添加环境变量”,输入键值对,配置环境变量,例如,BAIDU_MAP_API_KEY: XXX。
      • 请求头:单击“添加请求头”,输入键值对,配置请求头。

      开启“加密参数”开关,可以将参数值以密文形式显示。

  5. 单击“安装”

    MCP安装完成后,可以在“我的MCP”页面查看。

更多操作

MCP服务创建完成后,可根据需要执行如表2所示的操作。

表2 更多操作

操作

步骤

卸载MCP服务

卸载后,MCP服务会下线,请谨慎操作。

“我的MCP”页面,将鼠标光标移至MCP卡片上,单击“卸载”

查看MCP服务概览

“我的MCP”页面,单击MCP卡片,选择“概览”页签,可以查看MCP的服务描述、服务介绍、能力以及使用说明等信息。

查看工具

“我的MCP”页面,单击MCP卡片,选择“工具”页签,可以查看MCP支持的工具详情并测试工具运行效果。

查看运行监控

支持对MCP服务的调用次数、成功率及操作日志进行监控,以便实时掌握服务运行状态。

“我的MCP”页面,单击MCP卡片,选择“运行监控”页签,在运行监控页面直观展示了近30天、近7天、近24小时的调用次数统计总览,并支持查看调用次数、调用成功率及日志信息。

  • “调用次数”面板默认展示近30天的MCP服务调用次数,以及当前时间跨度内调用次数的最大值和最小值。

    单击右上角的时间选择下拉框,可切换查看近30天、近7天或近24小时的调用次数。

  • “调用成功率”面板默认展示近30天的MCP服务调用成功率,以及当前时间跨度内调用成功率的最大值和最小值。

    单击右上角的时间选择下拉框,可切换查看近30天、近7天或近24小时的调用成功率。

  • “日志”区域可以查看MCP服务在运行过程中自动生成的日志信息,支持按时间或日志名称查询符合条件的日志信息。

相关文档

MCP服务创建完成后,支持在Agent开发过程中添加使用,具体介绍请参见在AI原生应用引擎中创建单Agent(自主规划模式)在AI原生应用引擎中创建单Agent(复杂任务规划)

相关文档