Tcs N8n MCP

@设计/tcs-n8n-mcp

通过AI助手管理您的n8n工作流程

](https://www.npmjs.com/package/@thecodesaiyan/tcs-n8n-mcp)  ](https://nodejs.org)  

一 主控程序 服务器，让AI助手完全控制您的 n8n 工作流自动化平台。通过自然语言列出、创建、更新、执行和管理工作流、执行、标记、变量、凭据和用户。

安装 · 工具 · 安全 · 发展

______________________________________________________________________

特性

• 22工具 涵盖完整的n8n REST API
• 适用于所有地方 --克劳德代码，克劳德桌面，VS代码，光标，风帆，Cline
• 缺省安全 --ID验证、经过净化的错误、隐藏的秘密、请求超时
• 灵活的身份验证 -API密钥（默认）、承载令牌或基本身份验证
• 零配置 -只需提供n8n API密钥即可
• 轻量级 --在30KB以下，除了MCP SDK和Zod之外，没有运行时依赖关系

______________________________________________________________________

先决条件

• >= 18
• 一 n8n 实例（自托管或云）
• n8n API密钥(如何创建一个)

______________________________________________________________________

安装

快速开始

npx @thecodesaiyan/tcs-n8n-mcp --setup

安装向导将引导您完成配置，测试您的连接，并为MCP客户端输出可粘贴的配置。

Windows用户： npx 无法解析Windows上作用域包中的bin命令。改为全局安装： ``bash npm install -g @thecodesaiyan/tcs-n8n-mcp tcs-n8n-mcp --setup ``

环境变量

身份验证类型

• apikey （默认）--发送 X-N8N-API-KEY 头球这是n8n的标准API身份验证。
• bearer --发送 Authorization: Bearer 头球
• basic --发送 Authorization: Basic 头球需要 N8N_API_USER 待设定。

______________________________________________________________________

客户端设置

Claude Code

选项A：交互式向导

npx @thecodesaiyan/tcs-n8n-mcp --setup

选项B:CLI命令

macOS/Linux：

claude mcp add n8n -e N8N_API_URL=http://localhost:5678 -e N8N_API_KEY=your-api-key -- npx -y @thecodesaiyan/tcs-n8n-mcp

视窗 （首先全局安装）：

npm install -g @thecodesaiyan/tcs-n8n-mcp
claude mcp add n8n -e N8N_API_URL=http://localhost:5678 -e N8N_API_KEY=your-api-key -- tcs-n8n-mcp

选项C：手动配置

增添 ~/.claude.json:

macOS/Linux：

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@thecodesaiyan/tcs-n8n-mcp"],
      "env": {
        "N8N_API_KEY": "your-api-key-here",
        "N8N_API_URL": "http://localhost:5678"
      }
    }
  }
}

窗户：

{
  "mcpServers": {
    "n8n": {
      "command": "tcs-n8n-mcp",
      "args": [],
      "env": {
        "N8N_API_KEY": "your-api-key-here",
        "N8N_API_URL": "http://localhost:5678"
      }
    }
  }
}

Claude Desktop

添加到您的Claude Desktop配置文件中：

macOS/Linux：

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@thecodesaiyan/tcs-n8n-mcp"],
      "env": {
        "N8N_API_KEY": "your-api-key-here",
        "N8N_API_URL": "http://localhost:5678"
      }
    }
  }
}

视窗 （奔跑 npm install -g @thecodesaiyan/tcs-n8n-mcp 第一）：

{
  "mcpServers": {
    "n8n": {
      "command": "tcs-n8n-mcp",
      "args": [],
      "env": {
        "N8N_API_KEY": "your-api-key-here",
        "N8N_API_URL": "http://localhost:5678"
      }
    }
  }
}

保存后重新启动Claude Desktop。

VS Code (GitHub Copilot)

增添 .vscode/mcp.json 在您的项目中，或使用 命令面板 > MCP: Open User Configuration:

macOS/Linux：

{
  "servers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@thecodesaiyan/tcs-n8n-mcp"],
      "env": {
        "N8N_API_KEY": "your-api-key-here",
        "N8N_API_URL": "http://localhost:5678"
      }
    }
  }
}

视窗 （奔跑 npm install -g @thecodesaiyan/tcs-n8n-mcp 第一）：

{
  "servers": {
    "n8n": {
      "command": "tcs-n8n-mcp",
      "args": [],
      "env": {
        "N8N_API_KEY": "your-api-key-here",
        "N8N_API_URL": "http://localhost:5678"
      }
    }
  }
}

Cursor

增添 ~/.cursor/mcp.json （全球）或 .cursor/mcp.json （项目层面）：

macOS/Linux：

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@thecodesaiyan/tcs-n8n-mcp"],
      "env": {
        "N8N_API_KEY": "your-api-key-here",
        "N8N_API_URL": "http://localhost:5678"
      }
    }
  }
}

视窗 （奔跑 npm install -g @thecodesaiyan/tcs-n8n-mcp 第一）：

{
  "mcpServers": {
    "n8n": {
      "command": "tcs-n8n-mcp",
      "args": [],
      "env": {
        "N8N_API_KEY": "your-api-key-here",
        "N8N_API_URL": "http://localhost:5678"
      }
    }
  }
}

Windsurf

添加到您的Windsurf配置文件中：

macOS/Linux：

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@thecodesaiyan/tcs-n8n-mcp"],
      "env": {
        "N8N_API_KEY": "your-api-key-here",
        "N8N_API_URL": "http://localhost:5678"
      }
    }
  }
}

视窗 （奔跑 npm install -g @thecodesaiyan/tcs-n8n-mcp 第一）：

{
  "mcpServers": {
    "n8n": {
      "command": "tcs-n8n-mcp",
      "args": [],
      "env": {
        "N8N_API_KEY": "your-api-key-here",
        "N8N_API_URL": "http://localhost:5678"
      }
    }
  }
}

Cline

打开 MCP服务器 > 配置 > 高级MCP设置 并添加：

macOS/Linux：

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@thecodesaiyan/tcs-n8n-mcp"],
      "env": {
        "N8N_API_KEY": "your-api-key-here",
        "N8N_API_URL": "http://localhost:5678"
      }
    }
  }
}

视窗 （奔跑 npm install -g @thecodesaiyan/tcs-n8n-mcp 第一）：

{
  "mcpServers": {
    "n8n": {
      "command": "tcs-n8n-mcp",
      "args": [],
      "env": {
        "N8N_API_KEY": "your-api-key-here",
        "N8N_API_URL": "http://localhost:5678"
      }
    }
  }
}

______________________________________________________________________

可用工具（22）

工作流程（8）

处决（3）

标签（4）

变量（4）

证书（1）

用户（2）

______________________________________________________________________

安全

______________________________________________________________________

发展

git clone https://github.com/ntatschner/tcs-n8n-mcp.git
cd tcs-n8n-mcp
npm install

命令

在本地运行

# API key auth (default)
N8N_API_KEY=your-key N8N_API_URL=http://localhost:5678 npm start

# Bearer token auth
N8N_AUTH_TYPE=bearer N8N_API_KEY=your-token N8N_API_URL=http://localhost:5678 npm start

# Basic auth
N8N_AUTH_TYPE=basic N8N_API_USER=admin N8N_API_KEY=password N8N_API_URL=http://localhost:5678 npm start

项目结构

src/
  index.ts              Entry point, fetch wrapper, server setup
  config.ts             Auth type parsing, header building, timeout, connection check
  types.ts              Shared types, interfaces, response helpers
  validation.ts         Zod schemas for input validation
  tools/
    workflows.ts        Workflow CRUD, activation, execution
    executions.ts       Execution listing and management
    tags.ts             Tag CRUD operations
    variables.ts        Environment variable management
    credentials.ts      Credential metadata listing
    users.ts            User listing and details

______________________________________________________________________

贡献

欢迎投稿！请打开问题或提交拉取请求。

1. 分叉存储库
2. 创建功能分支(git checkout -b feat/my-feature)
3. 运行测试(npm test)
4. 提交您的更改(git commit -m 'feat: add my feature')
5. 推到分支(git push origin feat/my-feature)
6. 打开拉取请求

______________________________________________________________________

许可证