使用说明

🤖 N8N MCP服务器

一款专业且完整的模型上下文协议（MCP）服务器，将 N8N 与 Claude Desktop 集成在一起，可通过自然语言控制自动化工作流程。

✨ 特点

🚀 7 MCP工具 完全控制 N8N
🔄 重试逻辑 指数自动退货
💾 智能缓存 性能优化
🏥 健康检查 用于连接监控
🪟 支持 Windows 11 Pro 自动脚本
🍎 macOS 支持 经过测试和记录
🐧 与Linux兼容 通过代码空间
📚 完整文档 和详细
🔒 保险有隔离的凭据
⚡ 准备生产

🎯 这个服务器做什么？

将自然语言命令转换为 N8N 中的动作：

Você: "Liste meus workflows N8N"
Claude: Retorna lista de todos os workflows

Você: "Execute o workflow de backup"
Claude: Executa o workflow especificado

Você: "Verifique a saúde da conexão com N8N"
Claude: Retorna status, tempo de resposta e quantidade de workflows

🛠️ 可用的 MCP 工具

1. 健康检查 ⭐ 诺沃！

检查与 N8N 的连接和连接状态

从 API 返回状态
响应时间（秒）
工作流程总数
校验时间戳

2. list_workflows

列出所有可用的工作流程

按活动工作流过滤
名称，ID，状态，标签信息
创建和更新日期

3. get_workflow_details

获取工作流的完整详细信息

节点（Nodes）
我们之间的联系
工作流设置
标签和元数据

4. 执行工作流

执行特定的工作流程

自定义输入数据支持
返回执行 ID
运行状态

5. 获取执行状态

检查执行状态

状态（运行/完成）
开始和结束时间戳
返回数据

6. 激活工作流

启用或禁用工作流

状态控制（活动/非活动）
操作确认

7. 列表执行

🚀 快速安装

Windows 11专业版

选项 1：自动脚本（推荐）

# Clone o repositório
git clone https://github.com/jricardosouza/n8n-mcp-server.git
cd n8n-mcp-server

# Execute o script de setup
.\setup-windows.bat

选项 2：使用 PowerShell 完成设置

powershell -ExecutionPolicy Bypass -File setup-windows.ps1

📖 完整文档: WINDOWS_SETUP.md

macOS

# Clone o repositório
git clone https://github.com/jricardosouza/n8n-mcp-server.git
cd n8n-mcp-server

# Crie virtual environment
python3 -m venv venv
source venv/bin/activate

# Instale dependências
pip install -r requirements.txt

# Configure credenciais
cp .env.example .env
nano .env  # Configure N8N_API_URL e N8N_API_KEY

📖 完整文档: CLAUDE_DESKTOP_SETUP.md

GitHub代码空间

Acesse：https://github.com/jricardosouza/n8n-mcp-server
Clique em Code → Codespaces → Create codespace on main
配置机密：
- N8N_API_URL
- N8N_API_KEY

📖 完整文档: CODESPACE_SETUP.md

⚙️ 配置

1. N8N证书

编辑文件 .env:

N8N_API_URL=https://sua-instancia.n8n.io/api/v1
N8N_API_KEY=sua_chave_api_n8n_aqui

如何获取N8N的API密钥：

访问您的 N8N 实例
设置→ API
生成API密钥
复制生成的密钥

2.克劳德桌面

窗户：

# Localização do arquivo de configuração
%APPDATA%\Claude\claude_desktop_config.json

macOS：

# Localização do arquivo de configuração
~/Library/Application Support/Claude/claude_desktop_config.json

配置示例：

{
  "mcpServers": {
    "n8n-automation": {
      "command": "/caminho/completo/para/venv/bin/python",
      "args": [
        "/caminho/completo/para/src/n8n_mcp_server.py"
      ],
      "env": {
        "N8N_API_URL": "https://sua-instancia.n8n.io/api/v1",
        "N8N_API_KEY": "sua_chave_api_n8n_aqui"
      }
    }
  }
}

🧪 测试

手动服务器测试

窗户：

.\venv\Scripts\python.exe src\n8n_mcp_server.py

macOS/Linux：

./venv/bin/python src/n8n_mcp_server.py

如果出现空白屏幕等待输入，它正在工作！压力 Ctrl+C 出去。

测试无克劳德桌面

配置并重新启动 Claude 桌面后：

Verifique a saúde da conexão com N8N

预期响应：

{
  "status": "healthy",
  "api_url": "https://sua-instancia.n8n.io/api/v1",
  "response_time_seconds": 0.234,
  "total_workflows": 5,
  "timestamp": "2025-11-06T12:34:56"
}

📚 文档

安装指南

🪟 WINDOWS_SETUP.md -Windows 11 Pro的完整安装程序
🍎 CLAUDE_DESKTOP_SETUP.md -macOS设置
☁️ CODESPACE_SETUP.md -通过GitHub代码空间进行设置
☁️ CLOUD_SYNC_GUIDE.md 多设备同步

使用指南

🚀 VSCODE_PUSH_GUIDE.md 如何通过VS代码推送
🔧 故障排除.md - 解决问题
✅ 决议.md 已解决的问题

🆕 2.0 版本新闻

性能改进

⚡ 自动重试逻辑：最多 3 次尝试，指数回退
💾 智能缓存GET 请求的 5 分钟缓存
🏥 健康检查工具新诊断工具

错误改进

🎯 特定错误区分网络错误、超时和HTTP
📝 详细的消息更多信息用于诊断的错误
🔍 记录Aprimorado更详细的日志和调试级别

平台支持

🪟 Windows 11专业版自动化脚本和完整的文档
🍎 macOS经过测试和验证
🐧 Linux/代码空间通过容器支持

开发工具

📦 脚本取消设置：PowerShell e Batch para Windows
📖 扩展文档6个详细指南
🔧 Push 指南VS Code 与 Claude Code

🔒 安全

实施的最佳实践

✅ 隔离的凭据

档案 .env 未承诺（.gitignore)
独立的环境变量
GitHub Codespaces 秘密支持

✅ 输入验证

启动时验证凭据
请求超时 30 秒
强大的错误处理

✅ 网络安全

重试限于3次尝试
避免过载的指数退避
HTTP 状态检查

🛠️ 开发

项目结构

n8n-mcp-server/
├── src/
│   └── n8n_mcp_server.py       # Servidor MCP principal
├── .devcontainer/
│   └── devcontainer.json        # Configuração Codespace
├── .vscode/
│   ├── settings.json            # Configurações VS Code
│   ├── extensions.json          # Extensões recomendadas
│   └── tasks.json               # Tasks automatizadas
├── setup-windows.ps1            # Setup PowerShell para Windows
├── setup-windows.bat            # Setup Batch para Windows
├── requirements.txt             # Dependências Python
├── .env.example                 # Template de credenciais
├── .gitignore                   # Arquivos ignorados
├── WINDOWS_SETUP.md             # Guia Windows
├── CLAUDE_DESKTOP_SETUP.md      # Guia macOS
├── CODESPACE_SETUP.md           # Guia Codespaces
├── VSCODE_PUSH_GUIDE.md         # Guia de push
├── TROUBLESHOOTING.md           # Resolução de problemas
├── CLOUD_SYNC_GUIDE.md          # Sincronização
├── RESOLVED.md                  # Problemas resolvidos
└── README.md                    # Este arquivo

依赖关系

mcp >= 0.9.0         # Model Context Protocol
fastmcp >= 0.2.0     # FastMCP framework
httpx >= 0.24.0      # Cliente HTTP async
python-dotenv >= 1.0.0  # Gerenciamento de .env
tenacity >= 8.2.0    # Retry logic

贡献

欢迎捐款！请：

Fork 仓库
创建分支： git checkout -b feature/nova-funcionalidade
提交您的更改： git commit -m 'feat: Nova funcionalidade'
按下一个分支： git push origin feature/nova-funcionalidade
Abra um Pull请求

📖 另请参阅： VSCODE_PUSH_GUIDE.md

🐛 故障排除

视窗

错误：“python 无法识别为命令”

重新安装Python marcando“将Python添加到PATH”

错误：“模块无基础错误”

.\venv\Scripts\Activate.ps1
pip install -r requirements.txt

Claude Desktop 无法识别服务器

检查路径 claude_desktop_config.json
完全重新启动克劳德桌面（通过托盘日期）

macOS

错误：“ModuleNotFoundError:没有名为'httpx'的模块”

source venv/bin/activate
pip install -r requirements.txt

服务器已连接但没有返回数据

检查 N8N 凭据 .env
测试： curl -H "X-N8N-API-KEY: $N8N_API_KEY" $N8N_API_URL/workflows

📖 完整文档: 故障排除.md

📊 项目状态

✅ 代码100%功能和测试
✅ 文档完整而详细
✅ 视窗：完全支持（V2.0）
✅ macOS：完全支持
✅ Linux/代码空间：完全支持
✅ 测试：在生产中验证
✅ 安全：隔离的凭据
✅ 演出优化缓存和重试

📝 许可证

麻省理工学院许可证-Veja 许可证为了细节。

👤 作者

里卡多·索萨 (@日里卡尔多索萨)

已创建2025年10月30日
上次更新2025年11月6日
版本: 2.0.0

🙏 致谢

Anthropic -克劳德AI和克劳德代码
N8N - 自动化平台
模型上下文协议 -MCP框架

🔗 链接乌斯

仓库: https://github.com/jricardosouza/n8n-mcp-server
问题: https://github.com/jricardosouza/n8n-mcp-server/issues
N8N云: https://n8n.io/cloud
克劳德桌面: https://claude.ai/download
MCP 文档: https://modelcontextprotocol.io/

⭐ 如果这个项目有帮助，请考虑在GitHub上给它一颗星！

使用说明

🤖 N8N MCP服务器

✨ 特点

🎯 这个服务器做什么？

🛠️ 可用的 MCP 工具

1. 健康检查 ⭐ 诺沃！

2. list_workflows

3. get_workflow_details

4. 执行工作流

5. 获取执行状态

6. 激活工作流

7. 列表执行

🚀 快速安装

Windows 11专业版

macOS

GitHub代码空间

⚙️ 配置

1. N8N证书

2.克劳德桌面

🧪 测试

手动服务器测试

测试无克劳德桌面

📚 文档

安装指南

使用指南

🆕 2.0 版本新闻

性能改进

错误改进

平台支持

开发工具

🔒 安全

实施的最佳实践

🛠️ 开发

项目结构

依赖关系

贡献

🐛 故障排除

视窗

macOS

📊 项目状态

📝 许可证

👤 作者

🙏 致谢

🔗 链接乌斯

相关 MCP

Flomo笔记服务

规范工作流管理工具

3D资产生成服务

文档搜索服务

Microsoft 365命令行管理服务器

AI文本人性化服务