hofmann/code.hofmanns.ai
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
code.hofmanns.ai/CLAUDE.md
hofmann 4654f87bb8 Initial setup: Claude Code + n8n MCP integration 
- CLAUDE.md with project docs and architecture
- n8n-mcp config example (.mcp.json.example)
- 7 gandalf skills (jump, hai, docker, status, remote-env, orchestrate, skills)
- hai-infra + hai-tasks MCP server connections
- .gitignore for secrets

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 20:59:10 +00:00

2.7 KiB
Raw Permalink Blame History

code.hofmanns.ai — Claude Code + n8n MCP Integration

AI-powered workflow builder for hofmanns.ai infrastructure. Based on Nate Herk's tutorial — 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

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"