AI导哈

MCP连接测试工作流

一个用于验证Claude Desktop中MCP连接器功能的n8n工作流，适用于初始设置验证、故障排除和开发测试。

  • by mapachekurt
  • 本地部署
  • 更新于
在 GitHub 查看 mapachekurt/n8n-mcp-manual-trigger-test

使用说明

MCP连接测试 - 手动触发

概述

一个简单的n8n工作流，旨在通过手动执行来验证MCP（模型上下文协议）连接器的功能。此工作流用于测试Claude Desktop集成的MCP服务器的连接状态。

目的

此工作流程作为诊断工具，用于验证所有Claude Desktop连接器是否已正确配置并处于运行状态。它提供了快速的健康检查功能，涵盖：

  • 线性积分
  • 超级记忆连接
  • Desktop Commander 文件系统访问
  • n8n MCP节点可用性

工作流结构

节点

  1. 手动触发（启动）

    • 类型： n8n-nodes-base.manualTrigger
    • 目的：允许手动执行以进行按需测试
    • 配置：无需参数

  2. 设置节点（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)

使用方法

安装

  1. 进口 workflow.json 导入到您的n8n实例中
  2. 无需凭据或配置
  3. 如果需要，可以激活工作流（不过手动触发不需要激活）

执行

  1. 在n8n编辑器中打开工作流
  2. 点击“执行工作流”按钮
  3. 审查“Claude Desktop Test”节点的输出数据
  4. 验证所有状态字段均显示连接成功

预期输出

{
  "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() }}

用例

  1. 初始设置验证

    • 在Claude Desktop配置完成后验证MCP连接器
    • 确认所有必需的集成均可访问

  2. 故障排除

    • 当MCP工具无响应时的快速诊断方法
    • 确定哪个特定的连接器可能存在故障

  3. 文档

    • 为系统文档生成状态报告
    • 随时间变化的轨道连接器可用性

  4. 开发测试

    • 验证开发环境设置
    • 确保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)

做出贡献

欢迎随时提交问题或拉取请求，以改进此诊断工作流程。

相关 MCP