墨刀MCP实战指南:高效打通AI工作流的必备技巧
最近墨刀更新到v5.8.0+,引入了一个挺有意思的变化:通过内置的MCP服务,可以直接对接外部系统,全程不用写一行代码。想象一下,在AI原型里自动调数据库查用户数据、实时拉取高德地图POI生成推荐列表,甚至把协作编辑的AI对话流一键同步到飞书多维表格——这些场景现在靠墨刀自己的MCP服务就能串联起来。
来看一下操作流程,其实就几个关键步骤。
确认墨刀已启用MCP服务支持
从v5.8.0开始,墨刀已经默认集成了MCP Client模块,但需要手动开启才能调用外部服务。具体路径:打开墨刀桌面端→左下角「设置」→「AI工作流」→勾选「启用MCP外部工具调用」。如果选项是灰色的,说明版本不够新,先升级再重启应用就好。
这一步千万别偷懒:【不勾选这个开关,后续所有MCP配置都不起作用】
在AI原型中插入MCP可调用节点
进入AI原型编辑画布,左侧工具栏找到「逻辑组件」,把「MCP工具调用」节点拖进去。这个节点外观是蓝色插头形状,悬停时会提示“连接外部系统”。
双击节点打开配置面板,系统会自动列出当前可用的MCP Server,比如fs(文件系统)、amap-maps(高德地图)、desktop-commander(桌面命令)、weather-server(天气服务)等。选择你要对接的服务,比如选amap-maps。
填写参数时有个小坑:城市字段必须传字符串,坐标字段必须传[经度,纬度]这样的数组格式。类型传错的话,调用会直接失败并且没有任何报错提示,排查起来比较头疼。
配置MCP Server连接参数(以PostgreSQL数据库为例)
第一步:在墨刀设置页→「MCP扩展」→「添加自定义Server」→选择「Database」类型。
第二步:填写连接信息。主机地址填内网数据库IP(比如192.168.1.100),端口填5432,数据库名填your_prod_db,用户名填readonly_user,密码填对应的密钥。需要特别提醒的是:密码是明文存储在本地配置文件中的,【千万不能用你平常开发库的管理员账号】。
第三步:点击「测试连接」,成功后会显示绿色对勾,点击「保存」。添加完成后,这个数据库Server就会出现在AI原型的MCP工具调用节点可选列表中。
构建带条件分支的AI-MCP工作流
实现方式有两种:
方法一:用「MCP工具调用」节点加上「条件判断」节点串联。举个例子,用户输入“附近咖啡馆”,触发amap-maps.search_poi工具,返回JSON结果,然后接条件判断节点。当result.length > 0时走“展示列表”分支,否则走“发起定位授权”分支。
方法二:在AI对话流中直接嵌入MCP指令。在对话节点的「响应文本」框里输入:
其中{{user_location}}会自动替换为用户GPS坐标(需提前申请定位权限)。
注意:嵌入式写法要求参数JSON严格合法,少一个引号或逗号都会导致整个AI对话流中断。调试阶段建议先用方法一验证通路是否跑通。
将MCP执行结果写回墨刀变量并驱动UI
在MCP工具调用节点右侧,勾选「将返回值存入变量」,输入变量名比如map_results,点击确定。
然后拖入「动态文本」组件,绑定数据源,选择「变量」,找到map_results,路径填$.pois[0].name(提取第一个POI名称)。
这一步的关键在于:MCP返回的是原始JSON,墨刀不会自动解析嵌套结构,【必须用$.语法精确指定路径,否则会显示undefined】。说白了,JSON给你了,但怎么取数据需要你自己写对路径。对于不熟悉JSON路径语法的同学,建议先在调试面板里看看返回结构再写。