🚀 n8n MCP 服务器

n8n MCP 服务器是基于模型上下文协议（MCP）构建的，它能让大语言模型（LLM）和 AI 代理无缝管理 n8n 工作流，极大提升工作流管理的便捷性与效率。

✨ 主要特性

• 可列出 n8n 的可用工作流，方便用户快速了解可使用的工作流资源。
• 支持查看工作流详细信息，便于深入掌握工作流的具体内容。
• 能够执行工作流，实现业务流程的自动化操作。
• 可监控工作流执行情况，及时掌握工作流的运行状态。
• 可以传递参数到工作流，满足不同场景下的个性化需求。
• 具备与 AI 代理兼容的 MCP 接口，增强了系统的扩展性和兼容性。

🚀 快速开始

安装与配置

1. 安装包

   npm install @dopehunter/n8n-mcp-server
   

2. 创建 .env 文件

   cp .env.example .env
   

3. 配置您的 n8n 连接 编辑 .env 文件并设置：

   • N8N_BASE_URL：您的 n8n 实例 URL（例如，http://localhost:5678/api）
   • N8N_API_KEY：您的 n8n API 密钥（在 n8n 设置中生成）

4. 启动服务器

   npm start
   

5. 测试服务器

   curl -X POST http://localhost:3000/mcp -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":"1","method":"mcp.tools.list","params":{}}'
   

常见问题和故障排除

• 连接被拒绝错误：请确保您的 n8n 实例正在运行并且可以通过指定的 URL 访问。
• API 密钥问题：请检查密钥是否正确配置。
• 端点不可用：请确保服务器已成功启动并在监听 3000 端口。

📦 安装指南

开发环境

• 启动开发服务器：

  npm run start:dev
  

• 构建项目：

  npm run build
  

• 运行测试：

  npm test
  

Docker 镜像构建

docker build -t mcp/n8n-mcp-server .

💻 使用示例

与Claude或其他 LLM 的配合

1. 启动 MCP 服务器：

   npm start
   

2. 配置您的 LLM 客户端以使用 MCP 服务器：
   • 对于 Claude Desktop，请参考“配置选项”部分。
   • 对于其他客户端，请指向服务器 URL（例如，http://localhost:3000/mcp）。
3. 您的 LLM 现在可以通过 MCP 命令直接使用 n8n 工作流了。

📚 详细文档

有关可用的 MCP 函数详细信息，请参阅 API 文档。

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

📄 许可证

本项目根据 ISC 许可证发布。