n8n统一MCP服务器
独立模型上下文协议（MCP）服务器 n8n工作流管理和节点文档
一个一体化的MCP服务器，为AI助手（Claude、Copilot、Cursor）提供对n8n实例工作流的完全访问，以及一个包含完整文档的全面540节点目录。
✨ 特性
- 540个节点，包含完整文档 -从本地n8n安装中提取的完整节点目录
- 版本匹配数据库 -数据库自动匹配您的n8n实例版本
- 工作流管理 -通过MCP创建、更新、删除和执行工作流
- AI助手集成 -适用于Claude、GitHub Copilot和Cursor
- 完全独立 -无需外部依赖或其他项目
- 综合文档 -每个节点都包含描述、类别、参数和使用提示
🚀 快速开始
先决条件
- 已安装Node.js 18+
- npm或纱线
- 具有API访问权限的n8n实例（2.0.0+）
- 人工智能助理（克劳德、副驾驶、光标）
安装
# Clone repository
git clone https://github.com/yourusername/n8n-cli-toolkit.git
cd n8n-cli-toolkit/mcp-server
# Install dependencies
npm install
# Copy environment template
cp .env.example .env配置
编辑 .env 使用您的设置：
# Required: Your n8n instance API URL
N8N_API_URL=https://your-n8n-instance.com/api/v1
# Required: Your n8n base URL
N8N_BASE_URL=https://your-n8n-instance.com
# Required: Your n8n API key (from Settings > API)
N8N_API_KEY=your_api_key_here
# Required: Your n8n version (e.g., n8n@2.0.3)
# This ensures the node database matches your instance
N8N_VERSION=n8n@2.0.3构建节点数据库
# First time: Extract 540 nodes with documentation (~1-2 minutes)
npm run rebuild-db
# Rebuilding for different n8n versions
N8N_VERSION=n8n@2.1.0 npm run rebuild-db启动服务器
# Development
npm run dev
# Production
npm run build
npm start📚 可用工具
节点文档（540个节点）
- search_n8n_nodes -按关键字搜索节点（轻量级搜索，排除大量数据以节省令牌）
- get_node_info -获取完整的节点详细信息，包括文档、参数和操作
- 列表_节点_类别 -获取所有可用节点类别
- get_nodes_by_category -获取特定类别中的所有节点
- get_ai_nodes -获取支持AI的节点列表
- get_database_version -检查您的数据库是为哪个n8n版本构建的
- fetch_node_catalog_from_github -从任何n8n GitHub版本标记中获取节点目录
工作流管理
- list_workflows -列出所有工作流及其状态和元数据
- get_workflow -按ID获取完整的工作流定义
- get_workflow_by_name -按名称获取工作流
- 创建工作流 -部署新工作流
- update_workflow -修改现有工作流
- 删除工作流 -删除工作流
- 切换工作流 -激活/停用工作流
- 执行工作流 -手动执行工作流
- getexecutions -获取工作流执行历史记录
- getexecution_details -获取详细的执行信息
🔗 与AI助手集成
VS代码+GitHub副本
添加 .vscode/settings.json:
{
"mcp.servers": {
"n8n-unified": {
"command": "node",
"args": ["${workspaceFolder}/mcp-server/dist/index.js"],
"env": {
"N8N_API_URL": "https://your-n8n-instance.com/api/v1",
"N8N_API_KEY": "your-api-key",
"MCP_MODE": "stdio",
"LOG_LEVEL": "error"
}
}
}
}克劳德桌面（macOS）
添加 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"n8n-unified": {
"command": "node",
"args": ["/path/to/mcp-server/dist/index.js"],
"env": {
"N8N_API_URL": "https://your-n8n-instance.com/api/v1",
"N8N_API_KEY": "your-api-key",
"MCP_MODE": "stdio"
}
}
}
}🔧 发展
构建
npm run build热重载开发模式
npm run dev重建节点数据库
npm run rebuild-db运行测试
npm test📊 项目统计
- 支持的节点： 540（来自n8n节点库和@n8n/n8n节点langchain）
- 带有文档的节点： 539/540
- 节点类别： 20+
- 支持AI的节点： 80+
- 数据库大小： ~5-10MB（SQLite）
🛠️ 建筑
mcp服务器由以下部分组成：
- 节点服务 -使用文档管理540节点SQLite数据库
- 按关键字搜索节点 - 提取元数据和文档 - 处理版本跟踪
- 工作流服务 -处理n8n API交互
- 工作流上的CRUD操作 - 执行管理 - 版本和状态跟踪
- MCP处理器 -将请求路由到适当的服务
- 工具注册 - 参数验证 - 响应格式
- 节点加载器 -动态加载n8n个节点
- 提取节点元数据 - 根据描述构建文档 - 跟踪节点版本
🔐 安全
- 没有存储凭据 -仅在运行时使用API密钥
- 本地数据库 -所有节点数据都保留在您的计算机上
- 无外部通话 -节点文档不需要GitHub访问权限
- API密钥保护 -永不承诺
.env带有凭据的文件 - 基于环境的配置 -通过环境变量获取所有敏感数据
📋 需求
- Node.js： 18.0.0或更高
- npm： 9.0.0或更高版本
- n8n实例： 2.0.0或更高版本
- 猛撞： 最低512MB（建议1GB以上）
- 储存： 约50MB用于数据库和依赖项
🤝 贡献
欢迎投稿！请随时提交问题或拉取请求。
📝 许可证
MIT许可证-请参阅 许可证 详情
📖 详细文件
有关更多信息，请参见 mcp服务器/README.md
🆘 故障排除
“数据库版本不匹配”
# Rebuild for your n8n version
N8N_VERSION=n8n@YOUR_VERSION npm run rebuild-db“API密钥不工作”
- 在浏览器中打开n8n实例
- 前往设置→ API
- 创建或检索API密钥
- 更新
.env
“找不到节点”
# Ensure database was built
npm run rebuild-db📞 支持
- 检查 mcp服务器/README.md 获取详细文档
- 审查
- 咨询 n8n文档
📚 资源
______________________________________________________________________
由...制作❤️ 面向n8n自动化爱好者