如何快速上手n8n-mcp-server？5分钟搭建你的n8n工作流管理平台

【免费下载链接】n8n-mcp-server MCP server that provides tools and resources for interacting with n8n API 项目地址: https://gitcode.com/gh_mirrors/n8/n8n-mcp-server

n8n-mcp-server是一款强大的MCP服务器，为与n8n API交互提供工具和资源，帮助用户轻松搭建和管理n8n工作流管理平台。通过简单几步安装配置，即可快速开启高效的工作流管理之旅。

📦 三种快速安装方式，总有一款适合你

1. npm全局安装（推荐新手）

最简便的安装方式，一行命令即可完成：

npm install -g @leonardsellem/n8n-mcp-server

2. 源码安装（适合开发者）

如果你需要自定义或参与开发，可以从源码安装：

git clone https://gitcode.com/gh_mirrors/n8/n8n-mcp-server
cd n8n-mcp-server
npm install
npm install -g .  # 全局链接

3. Docker安装（适合容器化部署）

容器化部署更便于环境管理：

docker pull leonardsellem/n8n-mcp-server

⚙️ 简单配置，轻松搞定

创建环境配置文件

在服务器运行目录创建.env文件，配置n8n API密钥等必要信息：

N8N_API_KEY=your_n8n_api_key_here
N8N_BASE_URL=http://localhost:5678

详细配置说明可参考官方文档：docs/setup/configuration.md

注册MCP服务器

如果使用MCP安装器，可以通过以下命令注册服务器：

# 注册仓库版服务器
install_repo_mcp_server n8n-mcp-server

# 或注册本地安装的服务器
install_local_mcp_server path/to/n8n-mcp-server

🚀 启动服务器，开始使用

直接启动

如果是全局安装，直接运行：

n8n-mcp-server

源码启动

如果从源码安装，构建后启动：

npm run build
node build/index.js

Docker启动

使用Docker容器启动：

docker run -p 4000:4000 --env-file .env leonardsellem/n8n-mcp-server

✨ 常用功能快速体验

列出所有工作流

通过MCP工具获取工作流列表：

const workflows = await useMcpTool('n8n-mcp-server', 'workflow_list', {});

运行工作流

触发指定工作流执行：

const execution = await useMcpTool('n8n-mcp-server', 'execution_run', {
  workflowId: 'your_workflow_id'
});

创建新工作流

通过API创建自定义工作流：

const newWorkflow = await useMcpTool('n8n-mcp-server', 'workflow_create', {
  name: '我的新工作流',
  active: false
});

🛠️ 常见问题解决

服务器启动失败？

• 检查n8n服务是否已启动并正常运行
• 验证.env文件中的API密钥和URL是否正确
• 查看服务器日志获取详细错误信息

无法连接到n8n？

• 确保n8n允许远程连接
• 检查防火墙设置是否阻止了连接
• 验证网络连接和端口可用性

更多故障排除技巧，请参考：docs/setup/troubleshooting.md

📚 学习资源

• 官方文档：docs/index.md
• 开发指南：docs/development/index.md
• 示例代码：docs/examples/

通过以上步骤，你已经成功搭建了n8n-mcp-server工作流管理平台。开始探索更多高级功能，自动化你的工作流程吧！如有任何问题，欢迎参与项目贡献或提交issue。

【免费下载链接】n8n-mcp-server MCP server that provides tools and resources for interacting with n8n API 项目地址: https://gitcode.com/gh_mirrors/n8/n8n-mcp-server