n8n MCP 服务器

为n8n自动化设计的自定义模型上下文协议服务器,专为Antigravity AI助手优化,提供27种工具全面控制n8n实例。

  • by burnham
  • JavaScript
  • 本地部署
  • 14 星标
  • 更新于
在 GitHub 查看 burnham/n8n-mcp-server-custom

使用说明

🤖 n8n MCP服务器(自定义)

用于n8n自动化的自定义模型上下文协议服务器-专为反重力AI助手构建

🇪🇸 西班牙语版本 | 📚 文件


📖 英文版

⚠️ 重要提示

此MCP服务器是专门为 反重力.

为什么要定制服务器?

官方 @modelcontextprotocol/server-n8n 该包与Antigravity存在兼容性问题,导致持续 EOF(文件结束)错误 初始化期间:

Error calling 'initialize': EOF

我们的解决方案:

我们从头开始构建了这个实现,通过实现来复制官方服务器的功能 27个必备工具 基于n8n REST API。这保证了与Antigravity的完全兼容性,同时保持了与官方服务器的功能对等。

如果您在Antigravity中遇到相同的EOF错误,则此服务器是修复方法。

✨ 特性

  • 🔧 27个MCP工具 -完全控制您的n8n实例
  • 🎯 反重力优化 -专为Antigravity AI助手构建和测试
  • 🔒 安全 -API基于密钥的身份验证,代码中没有凭据
  • 📦 TypeScript -类型安全且可维护的代码库
  • 🚀 轻松设置 -在几分钟内克隆、配置和运行
  • 🔗 特征奇偶校验 -实现来自的基本功能 官方服务器

📸 行动结果

在n8n编辑器中可见测试工作流程,显示手动触发和设置数据节点。

Antigravity的MCP服务器管理面板中提供了所有27个MCP工具。

🚀 快速开始

# Clone the repository
git clone https://github.com/burnham/n8n-mcp-server-custom.git
cd n8n-mcp-server-custom

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your N8N_API_URL and N8N_API_KEY

# Build
npm run build

# Test connection (lists workflows)
npm test

🛠️ 可用工具(共27个)

工作流程(8个工具)

  • 列出、创建、更新、删除工作流
  • 使用自定义数据执行工作流
  • 激活/停用工作流

执行(3个工具)

  • 使用筛选器列出工作流执行情况
  • 获取执行详细信息
  • 停止执行

变量(5个工具)

  • 对环境变量执行完整的CRUD操作

证书(6个工具)

  • 管理凭据(仅元数据,机密受保护)

节点类型(2个工具)

  • 列出并查询可用的节点类型

标签(1个工具)

  • 列出工作流标签

系统(2个工具)

  • 实例运行状况和版本信息
  • 连接自检

🔧 反重力配置

编辑您的Antigravity配置文件:

窗户: C:\Users\[YOUR_USER]\.gemini\antigravity\mcp_config.json

Mac/Linux: ~/.gemini/antigravity/mcp_config.json

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/n8n-mcp-server-custom/dist/index.js"],
      "env": {
        "N8N_API_URL": "https://your-instance.n8n.cloud",
        "N8N_API_KEY": "your_api_key_here"
      }
    }
  }
}

重要提示:

  • 使用绝对路径
  • 替换 [YOUR_USER] 使用您的实际用户名
  • 从n8n设置获取API密钥→ API

📚 文档

🔒 安全

  • ✅ .env 文件被忽略
  • ✅ 源代码中没有凭据
  • ✅ API密钥从未在提交中公开
  • ✅ 安全的环境变量处理

🤝 贡献

欢迎投稿!请随时提交拉取请求。

📄 许可证

MIT许可证-请参阅 许可证 详细信息文件

👤 作者

乔治斯·伯纳姆H。


🇪🇸 西班牙语版本

⚠️ 不重要

这个MCP服务器是专门为 反重力.

为什么要定制服务器?

官方套餐 @modelcontextprotocol/server-n8n 与Antigravity的兼容性问题,导致 错误EOF(文件结束) 初始化期间持久:

Error calling 'initialize': EOF

我们的解决方案:

这个定制实现是从头开始构建的,通过实现 27基本工具 基于N8N的REST API。这确保了与Antigravity的完全兼容性,同时保持与官方服务器的功能对等。

如果您在Antigravity中遇到相同的EOF错误,则此服务器是解决方案。

✨ 特点

  • 🔧 27 MCP工具 -完全控制您的N8N实例
  • 🎯 针对反重力优化 -专门为IA Antigravity助理建造和测试
  • 🔒 保险 -通过API密钥进行身份验证,代码中没有凭据
  • 📦 TypeScript -代码库类型-安全和可维护
  • 🚀 易于配置 -在几分钟内克隆、配置和运行
  • 🔗 函数奇偶性 -实现基本功能 官方服务器

📸 行动结果

测试工作流在N8N编辑器中可见,显示手动触发和设置数据节点。

Antigravity的MCP服务器管理面板上提供的27个MCP工具。

🚀 快速启动

# Clonar el repositorio
git clone https://github.com/burnham/n8n-mcp-server-custom.git
cd n8n-mcp-server-custom

# Instalar dependencias
npm install

# Configurar variables de entorno
cp .env.example .env
# Edita .env con tu URL de n8n y API key

# Compilar
npm run build

# Probar conexión
npm test

🛠️ 可用工具(共27个)

工作流(8个工具)

  • 列出、创建、更新、删除工作流
  • 使用自定义数据运行工作流
  • 活动/活动工作流

执行(3个工具)

  • 使用筛选器列出工作流的执行
  • 查看执行细节
  • 停止正在进行的处决

变量(5个工具)

  • 环境变量中的完整CRUD操作

证书(6个工具)

  • 管理凭据(仅元数据,受保护的秘密)

节点类型(2个工具)

  • 列出和查询可用节点类型

标签(1个工具)

  • 工作流程列表标签

系统(2个工具)

  • 健康信息和实例版本
  • 自动连接测试

🔧 反重力配置

编辑您的反重力配置文件:

窗户: C:\Users\[TU_USUARIO]\.gemini\antigravity\mcp_config.json

Mac/Linux: ~/.gemini/antigravity/mcp_config.json

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "node",
      "args": ["/ruta/absoluta/a/n8n-mcp-server-custom/dist/index.js"],
      "env": {
        "N8N_API_URL": "https://tu-instancia.n8n.cloud",
        "N8N_API_KEY": "tu_api_key_aqui"
      }
    }
  }
}

重要提示:

  • 使用绝对路线
  • Reemplaza: [TU_USUARIO] 与您的实际用户
  • 从N8N设置中获取API密钥→API

📚 文件

🔒 安全

  • ✅ 文件 .env 伊吉尼奥尔
  • ✅ 源代码中没有凭据
  • ✅ 从未在提交中公开的API密钥
  • ✅ 安全处理环境变量

🤝 争议

欢迎捐款!毫不犹豫地发送拉动请求。

📄 许可证

MIT许可证-查看文件 许可证 更多细节

👤 作者

乔治斯·伯纳姆H。


⭐ 如果这个项目对你有用,在GitHub上给它一颗星!

⭐ 如果你觉得这个项目有用,在GitHub上给它一颗星!