星战科技xingzhan.cloud
返回市场
n8n_mcp服务器完整版

n8n_mcp服务器完整版

作者：dopehunter16 星标更新：2025-03-10
安装使用来源：spider==github.com

项目介绍

n8n MCP 服务器

一个模型上下文协议（MCP）服务器，通过Smithery模型上下文协议，使n8n工作流能够在大型语言模型（LLMs）和AI代理中无缝管理。

MCP 兼容 npm 版本

功能

  • 列出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实例正在运行，并且可以通过N8N_BASE_URL指定的URL访问。
  • API密钥问题：验证你的n8n API密钥是否正确并且具有适当的权限。
  • Docker问题：在尝试构建或运行Docker镜像之前，请确保Docker正在运行。

更多详细的故障排除，请参阅故障排除指南。

组件

工具

  • n8n_list_workflows

    • 列出n8n实例中的所有工作流
    • 输入：无

  • n8n_get_workflow

    • 获取特定工作流的详细信息
    • 输入：workflowId（字符串，必需）：要检索的工作流ID

  • n8n_execute_workflow

    • 执行n8n工作流
    • 输入：
      • workflowId（字符串，必需）：要执行的工作流ID
      • data（对象，可选）：传递给工作流的数据

  • n8n_get_executions

    • 获取工作流的执行历史
    • 输入：
      • workflowId（字符串，必需）：要获取执行记录的工作流ID
      • limit（数字，可选）：返回的最大执行记录数

  • n8n_activate_workflow

    • 激活工作流
    • 输入：workflowId（字符串，必需）：要激活的工作流ID

  • n8n_deactivate_workflow

    • 停用工作流
    • 输入：workflowId（字符串，必需）：要停用的工作流ID

预备条件

  • Node.js（v14及以上）
  • 具有API访问权限的n8n实例
  • 支持模型上下文协议的大型语言模型（LLM）或AI代理

配置选项

Docker配置

{
  "mcpServers": {
    "n8n": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "-e", "N8N_API_KEY=$N8N_API_KEY", "-e", "N8N_BASE_URL=$N8N_BASE_URL", "mcp/n8n-mcp-server"]
    }
  }
}

NPX配置

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@dopehunter/n8n-mcp-server"]
    }
  }
}

安装

NPM

npm install @dopehunter/n8n-mcp-server

直接使用npx

npx @dopehunter/n8n-mcp-server

从源码安装

git clone https://github.com/dopehunter/n8n_MCP_server_complete.git
cd n8n_MCP_server_complete
npm install
cp .env.example .env
# 编辑.env文件，填写你的n8n API详情

开发

启动开发服务器：

npm run start:dev

构建项目：

npm run build

运行测试：

npm test

使用Claude或其他LLMs

  1. 启动MCP服务器：

    npm start

  2. 配置你的LLM客户端以使用MCP服务器：

    • 对于Claude Desktop，使用“配置选项”部分中的配置。
    • 对于其他客户端，指向服务器URL（例如：http://localhost:3000/mcp）。

  3. 现在，你的LLM可以直接通过MCP命令使用n8n工作流。

构建Docker镜像

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

API文档

查看API文档了解可用的MCP函数详情。

贡献

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

许可证

此项目采用ISC许可证。