How czlonkowski/n8n-mcp works
n8n-MCP is an MCP server that gives AI assistants structured access to n8n node knowledge and tools for managing workflows. The main path is an assistant making MCP requests, tool dispatch into discovery, validation, or management handlers, and—where requested—calls to an n8n instance. The repository also documents templates, community-node discovery, and UI results as product capabilities. Storage and parsing support the knowledge layer. Several subsystem links are documented rather than verified in sampled implementation; those links are dashed, and unsampled internals are not inferred.
Main entry points: server.ts MCP Server · node-repository.ts Node Repository · handlers-n8n-manager.ts n8n Handlers · workflow-validator.ts Workflow Validator
Components 19
MCP Runtime
- MCP Server
src/mcp/server.ts - Tool Definitions
src/mcp/tools.ts - Management Tools
src/mcp/tools-n8n-manager.ts
Node Knowledge
- Node Parser
src/parsers/node-parser.ts
Workflow Tools
- n8n Handlers
src/mcp/handlers-n8n-manager.ts - Official MCP Tools
src/mcp/handlers-official-tools.ts - n8n API Client
src/services/n8n-api-client.ts - Workflow Diff Handlers
src/mcp/handlers-workflow-diff.ts - Diff Engine
src/services/workflow-diff-engine.ts - Workflow Validator
src/services/workflow-validator.ts - Configuration Validator
src/services/enhanced-config-validator.ts
Product Extensions
- Community Nodes
src/community/community-node-service.ts - Template Library
src/templates/template-service.ts - Tool Result UIs
ui-apps/src/apps/validation-summary/App.tsx
Knowledge Storage
- Node Repository
src/database/node-repository.ts - Database Adapter
src/database/database-adapter.ts
Other components
- AI Assistant
- n8n Instance
- Local Database
Connections 20
- AI Assistant → MCP Server: sends MCP requests
README.md - MCP Server → Tool Definitions: dispatches tools
src/mcp/server.ts - MCP Server → Management Tools: registers tools
src/mcp/server.ts - Management Tools → n8n Handlers: routes management
- n8n Handlers → n8n API Client: calls API
src/mcp/handlers-n8n-manager.ts - n8n API Client → n8n Instance: manages workflows
- MCP Server → Official MCP Tools: dispatches tools
src/mcp/server.ts - Official MCP Tools → n8n Instance: uses instance MCP
- n8n Handlers → Diff Engine: applies workflow diffs
- Workflow Diff Handlers → Diff Engine: uses diff engine
src/mcp/handlers-workflow-diff.ts - Workflow Diff Handlers → Workflow Validator: validates workflows
src/mcp/handlers-workflow-diff.ts - Workflow Validator → Configuration Validator: validates node settings
src/services/workflow-validator.ts - Workflow Validator → Node Repository: reads node data
src/services/workflow-validator.ts - MCP Server → Node Repository: serves node discovery
src/mcp/server.ts - Node Repository → Node Parser: parses node data
src/database/node-repository.ts - Node Repository → Database Adapter: uses adapter
src/database/node-repository.ts - Database Adapter → Local Database: reads and writes
- MCP Server → Community Nodes: offers community search
- MCP Server → Template Library: offers template search
src/mcp/server.ts - MCP Server → Tool Result UIs: serves tool interfaces
src/mcp/server.ts