MCP连接测试 - 手动触发
概述
一个简单的n8n工作流,旨在通过手动执行来验证MCP(模型上下文协议)连接器的功能。此工作流用于测试Claude Desktop集成的MCP服务器的连接状态。
目的
此工作流程作为诊断工具,用于验证所有Claude Desktop连接器是否已正确配置并处于运行状态。它提供了快速的健康检查功能,涵盖:
- 线性积分
- 超级记忆连接
- Desktop Commander 文件系统访问
- n8n MCP节点可用性
工作流结构
节点
- 手动触发(启动)
- 类型: n8n-nodes-base.manualTrigger - 目的:允许手动执行以进行按需测试 - 配置:无需参数
- 设置节点(Claude 桌面测试)
- 类型: n8n-nodes-base.set - 目的:生成所有MCP连接的状态报告 - 输出: - status整体连接状态信息 - linear_status线性API连接状态 - supermemory_status超级记忆连接状态 - desktop_commander_status文件系统访问状态 - n8n_mcp_statusn8n节点可用性 - test_time测试执行的ISO时间戳
工作流程逻辑
Manual Trigger → Set Node (Status Report)使用方法
安装
- 进口
workflow.json导入到您的n8n实例中 - 无需凭据或配置
- 如果需要,可以激活工作流(不过手动触发不需要激活)
执行
- 在n8n编辑器中打开工作流
- 点击“执行工作流”按钮
- 审查“Claude Desktop Test”节点的输出数据
- 验证所有状态字段均显示连接成功
预期输出
{
"status": "✅ All 4 Claude Desktop connectors working!",
"linear_status": "Connected - 2 teams",
"supermemory_status": "Connected - Kurt Anderson",
"desktop_commander_status": "Connected - Full filesystem access",
"n8n_mcp_status": "Connected - 525+ nodes available",
"test_time": "2025-10-12T12:41:28.660Z"
}配置
工作流设置
- 执行顺序v1(顺序)
- 错误数据保存所有错误执行记录
- 成功数据保存所有成功执行的结果
- 手动执行已保存
- 执行进度:已追踪
节点配置详情
手动触发
无需配置。仅提供手动工作流执行的入口点。
设置节点
使用n8n的分配系统(v3.4)来创建结构化输出:
- 每项任务都有一个唯一的ID用于追踪
- 状态消息的字符串类型赋值
- 使用n8n表达式生成动态时间戳:
={{ $now.toISO() }}
用例
- 初始设置验证
- 在Claude Desktop配置完成后验证MCP连接器 - 确认所有必需的集成均可访问
- 故障排除
- 当MCP工具无响应时的快速诊断方法 - 确定哪个特定的连接器可能存在故障
- 文档
- 为系统文档生成状态报告 - 随时间变化的轨道连接器可用性
- 开发测试
- 验证开发环境设置 - 确保MCP协议实现正常工作
故障排除
未生成输出
- 检查n8n是否具有适当的权限
- 验证手动触发节点是否正确连接
- 检查执行日志中的错误
错误的状态值
- 手动更新集合节点分配中的状态字符串
- 在Claude Desktop中验证实际连接器状态
- 检查MCP服务器日志以查找连接问题
工作流无法执行
- 确保工作流程已保存
- 检查n8n版本兼容性(Set节点需要v3.4+版本)
- 验证表达式中没有语法错误
技术细节
n8n 版本兼容性
- 最低支持的 n8n 版本:1.0.0
- 手动触发器:类型版本1
- 设置节点:类型版本 3.4
节点ID
- 手动触发:
manual - 设置节点:
set
连接架构
{
"Start": {
"main": [[{
"node": "Claude Desktop Test",
"type": "main",
"index": 0
}]]
}
}相关工作流
许可证
麻省理工学院(MIT)
作者
库尔特·安德森 (@mapachekurt)
做出贡献
欢迎随时提交问题或拉取请求,以改进此诊断工作流程。
