示例:快速接入modelscope魔塔社区mcp工具集-j9九游会登录
本示例将介绍如何在agentarts智能体平台中接入来自modelscope魔塔社区的开源mcp工具集,通过接入mcp工具集,智能体可以调用外部工具能力(如网页抓取、联网搜索等),扩展智能体的功能边界。
前提条件
mcp安装方式
agentarts智能体平台支持stdio(本地进程,含npx、uvx) 和http(远程网络,含streamable http、sse) 两类连接模式。
stdio(本地进程,含npx、uvx)
这里的本地指的是agentarts服务提供的运行环境,当选择stdio方式安装mcp时,平台会在内部下载并启动这个mcp。
npx:基于node.js生态的mcp服务。
uvx:基于python生态的mcp服务。
http(远程网络,含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安装方式。
步骤一:接入modelscope魔塔社区mcp工具集
- 注册并登录,进入“mcp广场”。选择“浏览器自动化”中的“fetch网页内容抓取”mcp。 图3 modelscope mcp广场
- 单击mcp名称,在详情页面可以查看mcp的配置信息。页面显示“fetch网页内容抓取”mcp无需鉴权即可使用;对于需要鉴权的mcp,请按照提示获取对应的api key。 图4 查看mcp配置信息
如果使用streamable http方式接入mcp,单击“连接”按钮即可获取到配置脚本;stdio方式同理,也可获取对应的配置脚本。
推荐优先选择streamable http方式,这是mcp协议推荐的远程连接方式,兼容性更好。仅当mcp提供方仅提供sse端点时,才选择sse方式。
图5 获取mcp配置脚本
- 登录。
- 在“组件库 > mcp”页签,单击“创建mcp > 空白创建”。
- 填写服务名称和服务描述(网页内容抓取、web page content scraping)。 图6 填写mcp名称与描述
- 删除页面中的示例,安装方式根据复制的mcp配置脚本进行选择。本示例选择“http”。配置录入方式选择“json编辑”。
- 复制modelscope魔塔社区获取的配置信息,填入至agentarts平台中。单击“安装”等待mcp安装成功。
安装无问题后,mcp状态将显示为“部署成功”。

如果mcp安装失败,多数原因是mcp本身的问题,如开源社区的mcp维护不及时或后端服务失效。遇到安装失败的情况,请尝试更换mcp来源。
步骤二:调试mcp
- 单击部署好的mcp,进入到详情页,可查看该mcp下属的工具信息。单击“工具列表”中操作列的“调试”,根据mcp服务定义的参数结构填写调试用例。单击“运行”进行功能验证。
由于本案例使用的是“fetch网页内容抓取”mcp,调试时可以输入一个网址,调试成功后,将显示出具体的网页内容。
如果调试返回空内容,对应的网址可能设置了反爬虫机制,导致无法抓取到具体内容。
如果mcp工具解析失败,多数原因是mcp本身的问题,如开源社区的mcp维护不及时或后端服务失效。遇到工具解析失败的情况,请尝试更换mcp来源。图7 调试mcp
- 在调试mcp时,请严格遵循参数格式要求,以避免出现错误。
- 使用“网页内容爬取”类mcp获取网页内容时,如目标网站设置了反爬虫防护(如robots限制、ip封禁、验证码等),可能导致抓取失败,这属于常见且正常的技术限制。
步骤三:在单智能体中使用mcp
- 在“智能体管理 > 单智能体”页面单击“创建单智能体”。填写单智能体名称、描述为“网页内容总结助手”。
- 设置提示词为将用户输入的url链接传递给“网页内容抓取”mcp获取正文,并进行总结。mcp获取不到网页内容时回复“无法获取网页内容”;选择一个可用的模型;选择已经安装好的网页内容抓取mcp。 图8 配置单智能体
- 在页面右侧输入测试链接,等待智能体输出结果。 图9 测试单智能体
由于本案例使用的是“fetch网页内容抓取”mcp,输入网址后,如果模型回复中包含了网页实际内容,即可判断出有调用mcp,或单击“调试”按钮,选择近期会话,在“调用详情”中也可以看到调用了mcp。
图10 查看调用详情
相关文档
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨