Laravel N8n MCP Server

Laravel n8n MCP服务器

一个Laravel包，它公开了完整的 n8n REST API和webhook功能 模型上下文协议（MCP） 工具——使每个n8n动作都可供AI代理和编码助手使用。

______________________________________________________________________

需求

• PHP 8.2+
• Laravel 11或12
• laravel/mcp >= 0.1.0
• kayedspace/laravel-n8n ^1.1

______________________________________________________________________

安装

1.要求包装

composer require rajurayhan/laravel-n8n-mcp-server

这也会安装 kayedspace/laravel-n8n 自动作为依赖。Laravel会自动发现服务提供者，无需手动注册。

2.发布配置

php artisan vendor:publish --tag=n8n-mcp-config

4.设置环境变量

# n8n API connection (required)
N8N_API_BASE_URL=https://your-n8n-instance.com/api/v1
N8N_API_KEY=your_api_key

# n8n webhook base URL (required for TriggerWebhook tool)
N8N_WEBHOOK_BASE_URL=https://your-n8n-instance.com/webhook
N8N_WEBHOOK_USERNAME=your_webhook_username   # optional basic auth
N8N_WEBHOOK_PASSWORD=your_webhook_password   # optional basic auth

# MCP route (optional, defaults shown)
N8N_MCP_ROUTE_PREFIX=mcp/n8n

MCP服务器将在 https://yourapp.com/mcp/n8n.

______________________________________________________________________

配置

// config/n8n-mcp.php
return [
    'route_prefix'     => env('N8N_MCP_ROUTE_PREFIX', 'mcp/n8n'),
    'route_middleware' => ['web'],  // add 'auth:sanctum' to restrict access
];

______________________________________________________________________

工具参考

54工具 在11个资源组中注册。中每个客户端类上的每个公共方法 kayedspace/laravel-n8n 具有相应的MCP工具。

工作流程（14个工具）

工作流标签（2个工具）

执行（4个工具）

凭证（6个工具）

用户（5个工具）

项目（7个工具）

变量（6个工具）

标签（7个工具）

源代码管理（1个工具）

安全/审计（1个工具）

Webhook（1个工具）

______________________________________________________________________

包结构

src/
├── N8nMcpServiceProvider.php       # Auto-discovered, registers the MCP route
├── Server/
│   └── N8nServer.php               # MCP server definition with all 54 tools
└── Tools/
    ├── Workflow/       (14 tools)
    ├── WorkflowTag/    (2 tools)
    ├── Execution/      (4 tools)
    ├── Credential/     (6 tools)
    ├── User/           (5 tools)
    ├── Project/        (7 tools)
    ├── Variable/       (6 tools)
    ├── Tag/            (7 tools)
    ├── SourceControl/  (1 tool)
    ├── Security/       (1 tool)
    └── Webhook/        (1 tool)

config/
└── n8n-mcp.php                     # Route prefix and middleware config

______________________________________________________________________

运作原理

每个工具：

1. 使用Laravel验证其输入参数 Validator
2. 调用相应的方法 N8nClient 立面从 kayedspace/laravel-n8n
3. 捕捉 N8nException （以及类似的子类 ExecutionFailedException)并返回 Response::error()
4. 退货 Response::structured() 成功时

这 kayedspace/laravel-n8n 该包通过您的 .env 设置。

______________________________________________________________________

中间件/身份验证

默认情况下，路线使用 web 中间件组。要限制MCP访问：

// config/n8n-mcp.php
'route_middleware' => ['web', 'auth:sanctum'],

______________________________________________________________________

许可证

麻省理工学院——见 许可证.