MCP mit N8N

mcp-autopeças mit n8n

MCP-Server in Python, der über das MCP-Protokoll Daten aus Google Sheets-Tabellen liest und schreibt – kompatibel mit Claude Desktop, Claude Code und jedem MCP-Client (einschließlich des mcpClientTool-Knotens in N8N).

Der Server deckt zwei Domänen in einem einzigen Prozess ab, wobei jede einer Tabelle in derselben Google Sheets-Datei zugeordnet ist:

Voraussetzungen

• Python 3.12+

• uv (empfohlen) oder pip

• Google Service Account mit Editor-Berechtigung für die Tabelle (erforderlich für leitos_atualizar_status_limpeza)

Installation

cd mcp-alura
uv sync          # ou: pip install -e .

Konfiguration

1. Google-Anmeldedaten (Service Account)

In der Google Cloud Console:

1. Erstellen Sie ein Projekt → APIs & Services → Aktivieren Sie die Google Sheets API

2. Erstellen Sie einen Service Account → generieren und laden Sie den JSON-Schlüssel herunter

3. Teilen Sie die Tabelle mit der E-Mail-Adresse des Service Accounts mit Editor-Berechtigung

2. Umgebungsvariablen

cp .env.example .env

Bearbeiten Sie die .env-Datei mit mindestens folgenden Einträgen:

SPREADSHEET_ID=1zt4h2v3ldK3zELNNmvyn02elEB9dHdfXD5q85ZYh2k0
AUTOPECAS_SHEET_NAME=AutoPeças
LEITOS_SHEET_NAME=Leitos
GOOGLE_CREDENTIALS_PATH=/caminho/para/service_account.json

# Para leitos_enviar_notificacao (e-mail):
GMAIL_USER=setor@hospital.com.br
GMAIL_APP_PASSWORD=xxxx_xxxx_xxxx_xxxx

# Para leitos_enviar_sms:
TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_FROM_NUMBER=+18647139932

Die SPREADSHEET_ID finden Sie in der URL: docs.google.com/spreadsheets/d/**{ID}**/edit

Erwartete Tabellenstruktur

Tabelle AutoPeças:

Tabelle Leitos — Spalten bestätigt durch das N8N-Knoten-Schema:

Die Spaltennamen können in der .env-Datei mit COL_* und LEITOS_COL_* angepasst werden.

Autoteile-Tools

Krankenhausbetten-Tools

Zuordnung der N8N-Agenten (mcp-all-nodes.json) zu Python-Tools:

Status_Ocupacao: Disponível 🟢 · Ocupado 🔴 · Reservado 🔵

Status_Limpeza: Concluído ✅ · Pendente ⚠️ · Em Andamento 🔄

Zimmertypen: Enfermaria · UTI · Apartamento · Semi-Intensivo

E-Mail-Versand konfigurieren

Das Tool leitos_enviar_notificacao verwendet Gmail SMTP mit einem App-Passwort:

1. Aktivieren Sie die Zwei-Faktor-Authentifizierung im Google-Konto

2. Besuchen Sie myaccount.google.com/apppasswords

3. Erstellen Sie ein Passwort für "E-Mail" und fügen Sie es in GMAIL_APP_PASSWORD in der .env ein

SMS-Versand konfigurieren

Das Tool leitos_enviar_sms verwendet die Twilio REST API:

1. Erstellen Sie ein Konto auf twilio.com

2. Rufen Sie Account SID und Auth Token im Dashboard ab

3. Registrieren oder kaufen Sie eine Absendernummer und konfigurieren Sie TWILIO_FROM_NUMBER

Verwendung in Claude Desktop

Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "hospital-mcp": {
      "command": "uv",
      "args": ["run", "--project", "/caminho/para/mcp-alura", "python", "server.py"],
      "env": {
        "SPREADSHEET_ID": "1zt4h2v3ldK3zELNNmvyn02elEB9dHdfXD5q85ZYh2k0",
        "AUTOPECAS_SHEET_NAME": "AutoPeças",
        "LEITOS_SHEET_NAME": "Leitos",
        "GOOGLE_CREDENTIALS_PATH": "/caminho/para/service_account.json",
        "GMAIL_USER": "setor@hospital.com.br",
        "GMAIL_APP_PASSWORD": "xxxx_xxxx_xxxx_xxxx",
        "TWILIO_ACCOUNT_SID": "ACxxxxxxxx",
        "TWILIO_AUTH_TOKEN": "xxxxxxxx",
        "TWILIO_FROM_NUMBER": "+18647139932"
      }
    }
  }
}

Verwendung in Claude Code

claude mcp add hospital-mcp -- uv run --project /caminho/para/mcp-alura python server.py

Verwendung in N8N (MCP Client)

Konfigurieren Sie den MCP Client Tool-Knoten, der auf den Endpunkt des Servers zeigt. Die drei N8N-Agenten können denselben Python-MCP-Server gemeinsam nutzen, wobei jeder die für seine Rolle geeigneten Tools über include: selected verwendet.

Lokaler Test

uv run python server.py

Um die 15 Tools mit dem MCP Inspector zu untersuchen:

npx @modelcontextprotocol/inspector uv run python server.py