Skip to main content
Glama
deenesjakoruzh
Siddharth0903

n8n-mcp

by Siddharth0903
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

n8n-mcp

CI Python 3.10+ License: MIT

这是最全面的 n8n MCP 服务器 —— 涵盖了整个 n8n REST API 接口，包含 43 个工具、8 个提示词模板 和 6 个可浏览资源。这是首个 Python 实现版本。

让 Claude（或任何兼容 MCP 的 AI 客户端）完全控制您的 n8n 实例：通过自然语言构建工作流、运行执行、管理凭据、查询数据表、进行安全审计等。

亮点

  • 43 个 MCP 工具 — 全面的 CRUD 操作，涵盖工作流、执行、凭据、标签、变量和数据表，以及安全审计和 API 能力发现等管理操作

  • 双重验证工作流创建 — create_and_validate_workflow 运行一个 6 阶段的流水线：创建、结构回读检查、两次执行测试、一致性比较以及通过/失败判定

  • 默认写入安全 — 所有修改操作默认禁用，除非您显式设置 N8N_MCP_WRITE_MODE=true

  • 8 个引导式提示词模板 — 用于调试、健康检查、安全审查、全测试工作流创建等的多步 AI 工作流

  • 异步与分页 — 基于 httpx 构建，支持基于游标的自动分页和可配置的超时时间

功能

分类

工具

工作流 (13)

list_workflows, get_workflow, create_workflow, update_workflow, delete_workflow, activate_workflow, deactivate_workflow, get_workflow_version, get_workflow_tags, update_workflow_tags, execute_workflow, trigger_webhook_test, create_and_validate_workflow

执行 (8)

list_executions, get_execution, delete_execution, retry_execution, stop_execution, stop_many_executions, get_execution_tags, update_execution_tags

凭据 (5)

list_credentials, create_credential, update_credential, delete_credential, get_credential_schema

标签 (5)

list_tags, get_tag, create_tag, update_tag, delete_tag

变量 (4)

list_variables, create_variable, update_variable, delete_variable

数据表 (5)

list_data_tables, get_data_table, create_data_table, query_table_rows, insert_table_rows

管理 (3)

generate_audit, discover_capabilities, source_control_pull

此外还有 8 个 MCP 提示词模板 和 6 个可浏览资源。

前置要求

  • Python 3.10+

  • n8n 实例 — 本地 (Docker) 或远程 (云托管)

  • n8n API 密钥 — 从 n8n 设置中生成

快速开始

1. 克隆并安装

git clone https://github.com/Siddharth0903/n8n-mcp.git
cd n8n-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

2. 启动 n8n (如果您尚未运行)

docker compose up -d

这将启动一个带有 PostgreSQL 的 n8n 实例，地址为 http://localhost:5678。

3. 获取您的 n8n API 密钥

  1. 在浏览器中打开 http://localhost:5678

  2. 如果是新实例，请完成初始设置

  3. 进入 Settings (齿轮图标) > n8n API

  4. 点击 Create an API key

  5. 复制密钥

4. 配置环境变量

cp .env.example .env

编辑 .env 文件并填入您的值：

N8N_MCP_BASE_URL=http://localhost:5678   # Your n8n URL
N8N_MCP_API_KEY=your-api-key-here        # The API key from step 3
N8N_MCP_WRITE_MODE=false                 # Set to 'true' to enable create/update/delete

5. 运行服务器

n8n-mcp

MCP 服务器现已通过 stdio 运行，随时可供任何 MCP 客户端连接。

客户端集成

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)：

{
  "mcpServers": {
    "n8n": {
      "command": "/absolute/path/to/your/.venv/bin/n8n-mcp",
      "env": {
        "N8N_MCP_BASE_URL": "http://localhost:5678",
        "N8N_MCP_API_KEY": "your-api-key-here",
        "N8N_MCP_WRITE_MODE": "true"
      }
    }
  }
}

提示： 请使用虚拟环境中 n8n-mcp 二进制文件的完整绝对路径。

Claude Code (CLI)

claude mcp add n8n -- /absolute/path/to/your/.venv/bin/n8n-mcp

或者添加到项目的 .mcp.json 中：

{
  "mcpServers": {
    "n8n": {
      "command": "/absolute/path/to/your/.venv/bin/n8n-mcp",
      "env": {
        "N8N_MCP_BASE_URL": "http://localhost:5678",
        "N8N_MCP_API_KEY": "your-api-key-here",
        "N8N_MCP_WRITE_MODE": "true"
      }
    }
  }
}

任意 MCP 客户端

n8n-mcp 使用标准的 MCP stdio 传输协议。任何兼容 MCP 的客户端都可以通过启动 n8n-mcp 二进制文件进行连接。

配置

所有设置均通过环境变量（或 .env 文件）进行配置：

变量

默认值

描述

N8N_MCP_BASE_URL

http://localhost:5678

n8n 实例 URL

N8N_MCP_API_KEY

(必填)

n8n API 密钥

N8N_MCP_WRITE_MODE

false

启用创建/更新/删除操作

N8N_MCP_TIMEOUT

30

HTTP 请求超时时间（秒）

N8N_MCP_MAX_ITEMS

100

默认分页限制

N8N_MCP_WEBHOOK_USERNAME

(可选)

Webhook 触发器的基本认证用户名

N8N_MCP_WEBHOOK_PASSWORD

(可选)

Webhook 触发器的基本认证密码

MCP 资源

可浏览的只读 n8n 数据视图：

URI

描述

n8n://workflows

所有工作流（包含名称、ID、激活状态和标签）

n8n://workflows/{id}

完整的工作流结构（包含节点和连接）

n8n://workflows/{id}/executions

特定工作流的执行历史

n8n://executions/{id}

详细的执行数据（包含每个节点的结果）

n8n://variables

所有实例变量

n8n://data-tables

所有带有模式的数据表

MCP 提示词

引导 AI 完成复杂操作的多步模板：

提示词

描述

debug_workflow

诊断和修复失败工作流的分步指南

workflow_health_check

审计所有工作流的健康状况和安全风险

execution_report

生成执行分析和成功率报告

find_workflow

查找符合自然语言描述的工作流

data_audit

分析数据表的结构、质量和内容

security_review

对 n8n 实例进行全面安全审查

create_and_test_workflow

创建新工作流并进行 6 阶段验证及交付检查

validate_workflow

对现有工作流进行端到端验证：结构、凭据、历史记录和实时测试

安全性

  • 默认关闭写入模式 — 在显式设置 N8N_MCP_WRITE_MODE=true 之前，仅支持读取操作

  • 凭据密钥绝不泄露 — n8n API 仅返回元数据，绝不返回密钥值

  • Webhook 路径验证 — 防止路径遍历和 SSRF 攻击

  • 结构化错误响应 — 每个错误都会返回带有提示的可操作 JSON，而非原始异常信息

  • 请求超时 — 可配置的超时时间防止连接挂起

架构

Claude / MCP Client
        |
        v
  +-----------+
  |  n8n-mcp  |  FastMCP server (Python, async)
  |           |
  | 43 tools  |  Workflows, Executions, Credentials,
  | 6 rsrc    |  Tags, Variables, Data Tables, Admin
  | 8 prompts |
  +-----+-----+
        | httpx (async, paginated)
        v
  +-----------+
  |  n8n API  |  REST /api/v1
  +-----+-----+
        |
        v
  +-----------+
  | Workflows |
  |  & Data   |
  +-----------+

开发

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest -v

# Lint
ruff check src/ tests/

# Type check
mypy src/

许可证

MIT

Install Server
A
security – no known vulnerabilities
A
license - permissive license
B
quality - B tier

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Siddharth0903/n8n-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server