n8n-mcp-server

n8n-mcp-server

site icon
2025.03.25 1
JavaScript工作流自动化JSON-RPC 接口开发效率
n8n-mcp-server 是一个基于 Model-Controller-Provider (MCP) 架构的服务器实现,专为 n8n 工作流自动化设计。它通过 JSON-RPC 协议提供标准化的接口,用于执行和管理 n8n 工作流。
View on GitHub

Overview

基本能力

产品定位

n8n-mcp-server 是一个用于 n8n 工作流自动化的 MCP 服务器实现,提供标准化的接口来执行和管理工作流。

核心功能

  • JSON-RPC 2.0 兼容的 API
  • 工作流执行和管理
  • 基于环境的配置
  • TypeScript 支持
  • 全面的日志记录
  • Docker 支持

适用场景

  • 自动化工作流执行
  • 工作流管理
  • 开发环境中的工作流测试

工具列表

  • initialize: 初始化服务器连接
  • shutdown: 优雅关闭服务器
  • listTools: 列出可用的工作流工具
  • callTool: 执行特定的工作流工具

常见问题解答

支持通过 GitHub 仓库提交问题获取支持。

使用教程

使用依赖

  • Node.js >= 14.0.0
  • 运行并可访问的 n8n 实例
  • n8n API 密钥

安装教程

  1. 克隆仓库:
git clone https://github.com/S17S17/n8n-mcp-server.git
cd n8n-mcp-server
  1. 安装依赖:
npm install
  1. 配置环境变量:
cp .env.example .env
# 编辑 .env 文件配置你的设置

调试方式

  • 标准启动:
npm start
  • 开发模式(热重载):
npm run start:dev
  • 简单模式(最小功能):
npm run start:simple
  • 调试模式:
npm run debug

Docker 支持

构建并运行 Docker 容器:

docker build -t n8n-mcp-server .
docker run -p 3000:3000 --env-file .env n8n-mcp-server

或使用 Docker Compose:

docker-compose up

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。