n8n MCP Homelab Setup¶

Hoe je een MCP (Model Context Protocol) server in Portainer draait en n8n workflows laat communiceren met je Obsidian vault.

Vereisten¶

• Docker + Portainer
• Obsidian met Local REST API plugin
• n8n (Docker)

Stap 1 — Obsidian Local REST API plugin¶

1. Obsidian → Settings → Community Plugins → zoek "Local REST API"
2. Installeer en activeer
3. Kopieer je API Key uit de plugin settings

Stap 2 — MCP Obsidian server in Portainer¶

version: '3.8'
services:
  mcp-obsidian:
    image: ghcr.io/kmackett/mcp-obsidian-docker:latest
    container_name: mcp-obsidian
    environment:
      - OBSIDIAN_API_KEY=jouw_obsidian_api_key_hier
    ports:
      - "27124:27124"
    volumes:
      - ./logs:/app/logs
    restart: unless-stopped
    networks:
      - homelab

networks:
  homelab:
    external: true

Portainer → Stacks → Add Stack → naam mcp-obsidian → plak YAML → vervang API key → Deploy.

Stap 3 — n8n MCP Client node installeren¶

Settings → Community Nodes → installeer: @nerding-io/n8n-nodes-mcp

Voeg toe aan n8n Docker Compose environment:

N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

Stap 4 — Credential instellen in n8n¶

HTTP Streamable (aanbevolen): - Type: MCP Client (HTTP Streamable) API - URL: http://mcp-obsidian:27124/stream

Beschikbare Obsidian MCP tools¶

Meerdere MCP servers combineren¶

services:
  mcp-obsidian:
    image: ghcr.io/kmackett/mcp-obsidian-docker:latest
    environment:
      - OBSIDIAN_API_KEY=jouw_obsidian_key
    ports:
      - "27124:27124"

  mcp-brave-search:
    image: mcp/brave-search:latest
    environment:
      - BRAVE_API_KEY=jouw_brave_key
    ports:
      - "27125:27124"

Troubleshooting¶

docker logs mcp-obsidian   # MCP server logs
docker logs n8n            # n8n logs

Verwant¶

• [[Opdracht 02 — Telegram Inbox Bot]]
• [[Lokale LLMs op Mac met LM Studio]]