82 lines
2.7 KiB
Markdown
82 lines
2.7 KiB
Markdown
|
# code.hofmanns.ai — Claude Code + n8n MCP Integration
|
||
|
|
|
||
|
|
> AI-powered workflow builder for hofmanns.ai infrastructure.
|
||
|
|
> Based on [Nate Herk's tutorial](https://youtu.be/B6k_vAjndMo) — Claude Code + n8n MCP integration.
|
||
|
|
|
||
|
|
## What This Project Does
|
||
|
|
|
||
|
|
Claude Code connects to **n8n** via the **n8n-mcp** server (Model Context Protocol) to:
|
||
|
|
- Search 1,200+ n8n nodes and their documentation
|
||
|
|
- Build, validate, and deploy n8n workflows
|
||
|
|
- Access workflow templates (2,700+)
|
||
|
|
- Manage workflows via the n8n REST API
|
||
|
|
|
||
|
|
Additionally connects to **hofmanns.ai infrastructure** via custom MCP servers:
|
||
|
|
- **hai-infra** (infra.hofmanns.ai) — shell, Docker, Caddy, filesystem on hai
|
||
|
|
- **hai-tasks** (mcp.hofmanns.ai) — task management
|
||
|
|
- **jetson-mcp** — GPU status, Docker on Jetson Orin
|
||
|
|
|
||
|
|
## Architecture
|
||
|
|
|
||
|
|
```
|
||
|
|
Claude Code (this machine)
|
||
|
|
├── n8n-mcp (npx) → localhost:5678 (n8n API)
|
||
|
|
├── hai-infra MCP → infra.hofmanns.ai:3100
|
||
|
|
├── hai-tasks MCP → mcp.hofmanns.ai:3847
|
||
|
|
└── jetson-mcp → jetson-mcp.hofmanns.ai:3100
|
||
|
|
```
|
||
|
|
|
||
|
|
## n8n Skills (7 installed)
|
||
|
|
|
||
|
|
| Skill | Purpose |
|
||
|
|
|-------|---------|
|
||
|
|
| n8n-mcp-tools-expert | Node search, workflow management via MCP |
|
||
|
|
| n8n-expression-syntax | {{}} patterns, $json, $node variables |
|
||
|
|
| n8n-workflow-patterns | 5 architectural patterns, 2,700+ templates |
|
||
|
|
| n8n-validation-expert | Error interpretation, auto-sanitization |
|
||
|
|
| n8n-node-configuration | Property dependencies, required fields |
|
||
|
|
| n8n-code-javascript | Code nodes, $input/$helpers, DateTime |
|
||
|
|
| n8n-code-python | Python in n8n, stdlib, limitations |
|
||
|
|
|
||
|
|
## Quick Reference
|
||
|
|
|
||
|
|
### n8n API
|
||
|
|
- **URL:** http://localhost:5678
|
||
|
|
- **API Key:** See credentials
|
||
|
|
- **Key Expires:** 2026-03-08 (renew!)
|
||
|
|
|
||
|
|
### Forgejo (git.hofmanns.ai)
|
||
|
|
- **API Key:** See credentials
|
||
|
|
- **SSH:** `ssh -p 2222 git@git.hofmanns.ai`
|
||
|
|
- **This repo:** `hofmann/code.hofmanns.ai`
|
||
|
|
|
||
|
|
### Key Conventions
|
||
|
|
- Always copy workflows before editing (never modify production directly)
|
||
|
|
- Test in development first
|
||
|
|
- Export backups before changes
|
||
|
|
- Webhook data is at `$json.body`, NOT root level
|
||
|
|
|
||
|
|
## Installed Components
|
||
|
|
|
||
|
|
```
|
||
|
|
~/.claude/.mcp.json # MCP server config (n8n-mcp + hai servers)
|
||
|
|
~/.claude/skills/ # 7 n8n skills
|
||
|
|
n8n-mcp-tools-expert/
|
||
|
|
n8n-expression-syntax/
|
||
|
|
n8n-workflow-patterns/
|
||
|
|
n8n-validation-expert/
|
||
|
|
n8n-node-configuration/
|
||
|
|
n8n-code-javascript/
|
||
|
|
n8n-code-python/
|
||
|
|
```
|
||
|
|
|
||
|
|
## Usage Examples
|
||
|
|
|
||
|
|
```
|
||
|
|
# Ask Claude Code to build workflows:
|
||
|
|
"Build a webhook workflow that receives JSON, processes it, and sends to Slack"
|
||
|
|
"Create an n8n workflow that monitors a URL and sends Telegram alerts on changes"
|
||
|
|
"Find me the Slack node and show its configuration options"
|
||
|
|
"Validate my workflow for errors"
|
||
|
|
```
|