文档首页/ 智能体开发平台 AgentArts/ 用户指南/ 组件库/ MCP/ 示例:快速接入ModelScope魔塔社区MCP工具集
更新时间:2026-03-09 GMT+08:00
分享

示例:快速接入ModelScope魔塔社区MCP工具集

本示例将介绍如何在AgentArts智能体开发平台中接入来自ModelScope魔塔社区的开源MCP工具集。

前提条件

MCP安装方式

AgentArts智能体开发平台支持Stdio(本地进程,含NPX、UVX) 和Streamable HTTP/SSE(远程网络) 两类连接模式。

图1 MCP安装方式

Stdio(本地进程,含NPX、UVX)

这里的本地指的是AgentArts服务提供的运行环境,当选择NPX、UVX方式安装MCP时,平台会在内部下载并启动这个MCP。

NPX:基于Node.js生态的MCP服务。

UVX:基于Python生态的MCP服务。

Streamable HTTP/SSE(远程网络)

远程指的是用户自己搭建的服务器MCP服务或者第三方提供的MCP服务。MCP服务代码并没有运行在AgentArts服务中,而是运行在别处(如通过本地电脑内网穿透暴露出来的地址、第三方MCP厂商提供的MCP API接口),平台仅作为客户端通过网络协议发起连接。

Streamable HTTP类型:基于标准HTTP协议的MCP连接方式,支持流式传输,是MCP协议推荐的远程连接方式,只需提供MCP服务的HTTP接口地址即可接入。

SSE类型:基于Server-Sent Events(服务器推送事件)协议的MCP连接方式,是较早期的远程连接方式,通过服务端主动向客户端推送数据实现实时通信,只需提供MCP服务的SSE接口地址即可接入。

接入MCP服务时,MCP提供方基本均会标注出MCP的安装方式,如果未明确写出,也可以从MCP的配置脚本中判断出来使用哪种方式进行安装。请选择合适的MCP安装方式。

图2 各类MCP服务安装方式示例

步骤一:接入ModelScope魔塔社区MCP工具集

  1. 注册登录ModelScope魔塔社区,进入“MCP广场”。选择“浏览器自动化”中的“Fetch网页内容抓取”MCP。

    图3 ModelScope MCP广场

  2. 单击MCP名称,在详情页面可以查看MCP的配置信息。页面显示“Fetch网页内容抓取”MCP无需鉴权即可使用;对于需要鉴权的MCP,请按照提示获取对应的API KEY。

    图4 查看MCP配置信息

    如果使用Streamable HTTP方式接入MCP,单击“连接”按钮即可获取到配置脚本;Stdio方式同理,也可获取对应的配置脚本。

    图5 获取MCP配置脚本

  3. 登录AgentArts智能体开发平台,在左侧导航栏“个人空间”区域,选择目标空间。
  4. 在“组件库 > MCP”页签,单击“创建MCP > 空白创建”。

    图6 创建MCP

  5. 填写服务名称和服务描述(网页内容抓取、Web page content scraping)。

    图7 填写MCP名称与描述

  6. 安装方式根据复制的MCP配置脚本进行选择,本示例选择“Streamable HTTP”。输入配置方式选择“JSON编辑”,并删除页面中的示例。

  7. 复制ModelScope魔塔社区获取的配置信息,填入至AgentArts平台中。单击“安装”等待MCP安装成功。

    如果MCP安装失败,多数原因是MCP本身的问题,如开源社区的MCP维护不及时或后端服务失效。遇到安装失败的情况,请尝试更换MCP来源。

步骤二:调试MCP

  1. 单击部署好的MCP,进入到“工具”页签,可查看该MCP下属的工具功能。MCP服务安装成功后会自动解析出MCP对应的工具能力。请参考ModelScope魔塔社区中MCP的功能介绍,输入参数值进行调试。

    图8 调试MCP
    • MCP工具解析失败,多数原因是MCP本身的问题,如开源社区的MCP维护不及时或后端服务失效。遇到工具解析失败的情况,请尝试更换MCP来源。
    • 在调试MCP时,请严格遵循参数格式要求,以避免出现错误。
    • 使用"网页爬取"类MCP获取网页内容时,如目标网站设置了反爬虫防护(如robots限制、IP封禁、验证码等),可能导致抓取失败,这属于常见且正常的技术限制。

步骤三:在单智能体中使用MCP

  1. 在“智能体管理 > 单智能体”页面单击“创建单智能体”。填写单智能体名称、描述为“网页内容总结助手”。

    图9 创建单智能体

  2. 设置提示词为将用户输入的url链接传递给“网页内容抓取”mcp获取正文,并进行总结。mcp获取不到网页内容时回复“无法获取网页内容”;选择一个可用的模型;选择已经安装好的网页内容抓取MCP。

    图10 配置单智能体

  3. 在页面右侧输入测试链接,等待智能体输出结果。

    图11 测试单智能体

    根据回答的内容即可判断出有调用MCP,或单击“调试”按钮,选择近期会话,在“调用详情”中也可以看到调用了MCP。

    图12 查看调用详情

相关文档