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

创建MCP服务

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

前提条件

如果需要接入自主开发的MCP服务,需确保该服务已完成独立部署。

自主开发的MCP服务需在服务器或本地上独立部署,并通过测试确保其能够正常运行。

创建MCP服务

  1. 登录Versatile智能体平台,在左侧导航栏“个人空间”区域,选择进入所需空间。

    如果已选择团队空间,界面显示为实际的团队空间名称,而非“个人空间”。

    图1 选择团队空间

  2. 在左侧导航栏选择“开发中心 > 组件库 > 我的MCP”,单击“创建”创建MCP服务。
  3. 在创建MCP服务的弹框中,您可以选择空白模板或平台提供的其他MCP服务模板,如图2所示。然后单击“下一步”继续操作。

    对于资产中心中未安装的预置MCP,您也可以按照以下步骤进入服务创建页面:在“资产中心 > MCP广场 ”页签,将鼠标光标移至MCP卡片上,单击“安装”按钮。
    • 空白模板:适用于安装开源社区的MCP或接入自主开发的MCP服务。
    • 平台预置MCP:适用于安装平台预置的MCP。
      图2 创建MCP服务

  4. 配置MCP服务,参数的具体说明请参考表1所示。

    表1 创建MCP服务参数说明

    参数

    说明

    服务图标

    MCP服务的图标,支持SVG、PNG、JPG、JPEG。

    服务名称

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

    命名规则:

    • 命名要求:仅支持以中英文开头;
    • 支持字符:中英文、数字、中划线(-)、下划线(_);
    • 长度限制:2~64个字符。

    服务描述

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

    服务介绍

    更详细地介绍该MCP服务的一些功能。例如,使用方式,关键能力,使用场景,注意事项等。

    安装方式

    选择MCP服务的安装方式,支持以下三种方式:

    • 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服务详情页获取配置代码。
      • 如果选择SSE方式接入自主开发的MCP服务,服务配置模板如下,请将“url”更换为该MCP服务的实际部署地址。
        {
            "mcpServers": {
                "example-sse": {
                    "url": "https://example.com?key=<您在服务官网上申请的key>"
                }
            }
        }
    • 使用表单编辑
      • 参数值:填写参数值时,多个参数值之间使用英文逗号分隔。例如,-y,@baidumap/mcp-server-baidu-map。
      • 环境变量:单击“添加环境变量”,输入键值对,配置环境变量,例如,BAIDU_MAP_API_KEY: XXX。
      • URL:外部环境部署的MCP服务的地址。例如https://example.com?key=<您在服务官网上申请的key>。仅在选择SSE方式安装时需要配置。
      • 请求头:单击“添加请求头”,输入键值对,配置请求头。

    加密功能:单击输入框右侧的密文图标,可将参数值加密显示

  5. 单击“保存”。MCP安装完成后,可以在“我的MCP”页面查看创建成功的MCP。
  6. 创建完成之后,可以在“我的MCP”页面查看MCP的部署状态,部署成功的MCP才能在智能体或工作流使用。

更多操作

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

表2 更多操作

操作

步骤

删除MCP服务

删除后,MCP服务会下线,请谨慎操作。

在“我的MCP”页面,在MCP卡片上单击“删除”按钮,注意此操作将导致MCP服务下线,请谨慎操作。

查看MCP服务概览

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

查看工具

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

相关文档