MCP n8n+光标+代码
Visao geral
此存储库集中了模型上下文协议 （MCP） 配置，以便将光标和编解码器与 n8n 实例集成。这个想法是简化团队的入职：一个单一的指南涵盖了从n8n的升级到与MCP客户的连接。此外，该项目还作为文档、操作规则和辅助脚本的版本化基础。
关于仓库
- 它作为一个集合的脚本，MCP清单和共享规则，旨在通过Cursor和Codex使用n8n。
- 这些文件旨在被任何团队成员快速克隆和适应。
- 所有内容都避免暴露真实的秘密；在贡献时保持相同的态度。
- 允许您从 Cursor 或 Codex 发送的自然语言提示符创建和编排 n8n 工作流。
最低要求
- 启用 MCP 支持的光标 。
- 已安装的 CLI 编码（如果使用终端流）。
- Node.js 18 或更高版本以运行软件包
n8n-mcp通过npx或全局安装。 - 可访问的 n8n 实例，具有基础 URL 和有效的 API 密钥。
- 设置本地环境变量和编辑文件的权限
~/.bashrc（或等效）
项目结构
.cursor/mcp.json: 光标消耗的 MCP 服务器配置（未版本化；下面的示例）。rules/n8n-mcp.mdc指导两个客户端的 MCP 代理的可选指令。docker-compose.ymln8n的本地堆栈示例，具有默认卷和定义。setup_n8n.sh：引导Linux com Nginx的脚本，让我们加密基本身份验证。
环境变量
在打开 Cursor 或 Codex 之前设置变量，以避免在文件中暴露密钥。
export N8N_API_URL="https://seu-n8n.example.com"
export N8N_API_KEY="SEU_TOKEN_GERADO_NO_N8N"- 为每个环境（生产、认证、本地）调整上述值。
- 将秘密存放在适当的保险箱或管理员中；永远不要承诺真正的价值观。
- 添加到 RC shell （例如
~/.bashrc只有当计算机是个人计算机并且变量受到保护时。
配置无光标
- 确保工作区有一个文件夹
.cursor/（版本）。添加到.gitignore如果还没有：
echo ".cursor/mcp.json" >> .gitignore- 创建文件
.cursor/mcp.json指向服务器n8n-mcp:
cat > .cursor/mcp.json MCP`请确认服务器 `n8n-mcp` 出现在名单上。
1. 使用简单的提示进行测试，例如： `Use o provedor n8n-mcp para listar workflows disponiveis.`
1. 如果需要调试，请更改 `LOG_LEVEL` 段落 `info` 然后查看 Cursor 的 MCP 面板。
## 食品法典委员会
1. 设置环境变量后，注册 MCP 服务器：codex mcp add n8n-mcp \ --env MCP_MODE=stdio \ --env LOG_LEVEL=error \ --env DISABLE_CONSOLE_OUTPUT=true \ --env N8N_API_URL=$N8N_API_URL \ --env N8N_API_KEY=$N8N_API_KEY \ -- npx n8n-mcp
1. 检查注册 ：codex mcp list
1. 要使用此仓库的规则文件，请根据您的计算机设置路径：codex --cd /home/taylao/n8n_mcp_workflows \ --config experimental_instructions_file='"/home/taylao/n8n_mcp_workflows/rules/n8n-mcp.mdc"'
1. 要永久化，请编辑 `~/.codex/config.toml` 定义：experimental_instructions_file = "/home/taylao/n8n_mcp_workflows/rules/n8n-mcp.mdc"
1. 执行一个简单的命令（例如： `tools_documentation()`验证与 MCP 的通信。
## 共享规则（`rules/n8n-mcp.mdc`)
文件 `.mdc` 包含操作指南（工作流命名、验证、标签）。在每台机器上复制或引用此文件以标准化交互。随着团队发展惯例，更新内容。
## 做n8n的规定
- 使用 `docker-compose.yml` 快速上传本地n8n与卷 `/home/taylao/mcpn8n/local_n8n/`.
- 执行 `setup_n8n.sh` 在Linux服务器上，如果您需要安装Nginx，HTTPS（让我们加密）和基本身份验证保护。
- 总是替换 `DOMAIN`, `EMAIL` 和脚本凭据在运行前的实际环境值。
## Como subir on 8n
### Ambiente本地com Docker编写
1. 调整音量或变量内 `docker-compose.yml` 根据你的目录。
1. 上传容器 ：docker compose up -d
1. 请检查日志以确认应用程序启动没有错误：docker compose logs -f n8n
1. 当您需要关闭：docker compose down
### Servidor Linux（Nginx+HTTPS）
1. 阿布拉 `setup_n8n.sh` 个性化 `DOMAIN`, `EMAIL` e `BASIC_USER` 与他们的价值观。
1. 以 root 或 via 身份运行脚本 `sudo`:sudo bash setup_n8n.sh
1. 脚本在下面创建目录 `/opt/n8n`上传容器，使用Basic Auth配置Nginx并自动请求Lets Encrypt证书。
1. 最后，验证在终端上打印的建议测试（HTTP/HTTPS重定向，身份验证和容器日志）。
## 良好安全实践
- 从不注册 `N8N_API_KEY`版本化文件中的密码或令牌。
- 使用环境变量或保险箱（例如 1Password、Vault、Secrets Manager）来保密。
- 在不再使用时，从 n8n 面板中撤销旧密钥。
- 限制对服务器（防火墙，VPN）的访问，并保持可审计的日志。
## 故障排除
- `curl -H "X-N8N-API-KEY: $N8N_API_KEY" "$N8N_API_URL/rest/workflows"` 在API中测试直接连接。
- 如果 Cursor 或 Codex 没有列出服务器，请确认工作区路径和 JSON 语法。 `mcp.json`.
- 认证错误通常表明当前的 shell 中没有装入无效或变量密钥 。
- 调整 `LOG_LEVEL` 段落 `info` 在命令/文件中，并观察发出的日志 `n8n-mcp`.
## 快速清单
- \[\]水痘 `N8N_API_URL` e `N8N_API_KEY` 只出口到当地环境。
- \[ \] `.cursor/mcp.json` 由 Git 创建并忽略。
- \[ \] `codex mcp add n8n-mcp` 执行（如果使用 Codex）。
- \[ \] 档案 `rules/n8n-mcp.mdc` 参考工具。
- \[ \] 此仓库中没有存储实际密钥或密码 。