MCP Server - Connection Key

Ein MCP (Model Context Protocol) Server mit verschiedenen nützlichen Tools für Cursor IDE.

Verfügbare Tools

Der Server stellt folgende Tools zur Verfügung:

1. ping

Test-Tool zur Überprüfung der Server-Verbindung.

• Parameter: Keine

• Ausgabe: "pong"

2. echo

Gibt den eingegebenen Text zurück. Nützlich zum Testen von Parametern.

• Parameter:

  • text (string): Der Text, der zurückgegeben werden soll

• Ausgabe: Der eingegebene Text

3. getDateTime

Gibt das aktuelle Datum und die aktuelle Uhrzeit zurück.

• Parameter:

  • timezone (string, optional): Zeitzone (z.B. 'Europe/Berlin'), Standard: UTC

• Ausgabe:

  • dateTime: Formatierte Datum/Zeit-String

  • timestamp: Unix-Timestamp

  • timezone: Verwendete Zeitzone

4. calculate

Führt mathematische Berechnungen durch.

• Parameter:

  • expression (string): Mathematischer Ausdruck (z.B. '2 + 2', '10 * 5', '2 ** 3')

• Unterstützte Operatoren: +, -, *, /, %, ** (Potenz)

• Ausgabe:

  • result: Berechnungsergebnis

  • expression: Ursprünglicher Ausdruck

5. generateUUID

Generiert eine eindeutige UUID (Universally Unique Identifier).

• Parameter:

  • version (enum, optional): UUID Version - "v4" (zufällig, Standard) oder "v1" (zeitbasiert)

• Ausgabe:

  • uuid: Generierte UUID

  • version: Verwendete Version

Related MCP server: MCPO - MCP over HTTP Proxy

n8n Integration Tools

6. callN8N

Ruft die n8n REST API auf. Kann Workflows starten, Daten senden oder abrufen.

• Parameter:

  • endpoint (string): API-Endpoint (z.B. '/api/v1/workflows' oder '/webhook/reading')

  • method (enum): HTTP-Methode - GET, POST, PUT, DELETE, PATCH (Standard: POST)

  • body (object, optional): Request Body als JSON-Objekt

  • headers (object, optional): Zusätzliche HTTP-Header

• Ausgabe:

  • status: HTTP-Status-Code

  • data: Antwort-Daten

  • success: Erfolgsstatus

7. createN8NWorkflow

Erstellt einen neuen n8n Workflow mit dem angegebenen Namen und Nodes.

• Parameter:

  • name (string): Name des Workflows

  • nodes (array): Array von Workflow-Nodes

  • active (boolean, optional): Workflow aktivieren (Standard: false)

  • tags (array, optional): Tags für den Workflow

• Ausgabe:

  • workflowId: ID des erstellten Workflows

  • name: Workflow-Name

  • nodeCount: Anzahl der Nodes

  • message: Statusmeldung

8. triggerN8NWebhook

Löst einen n8n Webhook-Workflow aus. Nützlich zum Starten von Automatisierungen.

• Parameter:

  • webhookPath (string): Webhook-Pfad (z.B. 'reading', 'matching', 'chart-analysis')

  • data (object): Daten, die an den Webhook gesendet werden sollen

• Ausgabe:

  • success: Erfolgsstatus

  • executionId: ID der Ausführung (optional)

  • message: Statusmeldung

Human Design Tools

9. generateReading

Generiert ein Human Design Reading basierend auf Geburtsdaten. Ruft n8n Workflow auf.

• Parameter:

  • birthDate (string): Geburtsdatum im Format YYYY-MM-DD

  • birthTime (string): Geburtszeit im Format HH:MM

  • birthPlace (string): Geburtsort

  • userId (string, optional): User-ID

  • readingType (enum, optional): Art des Readings - basic, detailed, business, relationship (Standard: basic)

• Ausgabe:

  • readingId: ID des generierten Readings

  • chartData: Chart-Daten

  • reading: Reading-Text

  • success: Erfolgsstatus

10. analyzeChart

Analysiert Human Design Chart-Daten und gibt detaillierte Informationen zurück.

• Parameter:

  • chartData (object): Chart-Daten (Typ, Zentren, Channels, etc.)

  • analysisType (enum, optional): Art der Analyse - type, centers, channels, gates, profile, full (Standard: full)

• Ausgabe:

  • analysis: Analyse-Ergebnisse

  • summary: Zusammenfassung

  • success: Erfolgsstatus

Matching Tools

11. matchPartner

Führt Human Design Partner-Matching zwischen zwei Personen durch.

• Parameter:

  • user1Chart (object): Chart-Daten der ersten Person

  • user2Chart (object): Chart-Daten der zweiten Person

  • matchingType (enum, optional): Art des Matchings - compatibility, relationship, business, full (Standard: compatibility)

  • userId1 (string, optional): User-ID der ersten Person

  • userId2 (string, optional): User-ID der zweiten Person

• Ausgabe:

  • matchId: ID des Matchings

  • compatibilityScore: Kompatibilitäts-Score (0-100)

  • analysis: Detaillierte Analyse

  • recommendations: Empfehlungen als Array

  • success: Erfolgsstatus

User Data Tools

12. saveUserData

Speichert User-Daten über n8n Webhook. Nützlich für App-User-Login und Datenverarbeitung.

• Parameter:

  • userId (string): User-ID

  • data (object): Zu speichernde Daten

  • dataType (enum, optional): Art der Daten - profile, chart, reading, preferences, custom (Standard: custom)

• Ausgabe:

  • success: Erfolgsstatus

  • recordId: ID des gespeicherten Records (optional)

  • message: Statusmeldung

Installation

Lokale Entwicklung

1. Stellen Sie sicher, dass Node.js installiert ist

2. Installieren Sie die Abhängigkeiten:

npm install

3. Konfigurieren Sie die n8n-Verbindung:

   • Öffnen Sie config.js

   • Passen Sie die n8n.baseUrl an Ihre n8n-Instanz an

   • Optional: Setzen Sie N8N_API_KEY als Umgebungsvariable, falls benötigt

   Oder setzen Sie Umgebungsvariablen:

   # Windows PowerShell
   $env:N8N_BASE_URL="https://n8n.deinedomain.tld"
   $env:N8N_API_KEY="your-api-key"
   
   # Linux/Mac
   export N8N_BASE_URL="https://n8n.deinedomain.tld"
   export N8N_API_KEY="your-api-key"

Hetzner Server Deployment

Für die Einrichtung auf einem Hetzner Server gibt es ein automatisches Setup-Script:

Schnellstart:

# Auf Hetzner Server
curl -o setup-hetzner.sh https://raw.githubusercontent.com/Heiko888/Connection-Key-MCP-Server/main/setup-hetzner.sh
chmod +x setup-hetzner.sh
sudo ./setup-hetzner.sh

Weitere Informationen:

• HETZNER_QUICKSTART.md - Schnelleinrichtung

• DEPLOYMENT_HETZNER.md - Detaillierte Anleitung

• ENV_SETUP_HETZNER.md - .env Datei Setup

Konfiguration in Cursor IDE

Um den MCP-Server in Cursor IDE zu verwenden, müssen Sie ihn in den Cursor-Einstellungen konfigurieren:

1. Öffnen Sie die Cursor-Einstellungen (File → Preferences → Settings)

2. Suchen Sie nach "MCP" oder "Model Context Protocol"

3. Fügen Sie die folgende Konfiguration hinzu:

{
  "mcpServers": {
    "mcp-server": {
      "command": "node",
      "args": [
        "C:\\AppProgrammierung\\Projekte\\MCP_Connection_Key\\index.js"
      ],
      "cwd": "C:\\AppProgrammierung\\Projekte\\MCP_Connection_Key"
    }
  }
}

Wichtig: Passen Sie die Pfade an Ihren System an!

Alternative: Verwendung von mcp.json

Die Datei mcp.json in diesem Projekt kann als Referenz dienen. Kopieren Sie den Inhalt in Ihre Cursor-Konfiguration.

Server starten (manuell)

Um den Server manuell zu testen:

npm start

Der Server läuft dann über stdio und wartet auf Verbindungen von Cursor.

Fehlerbehebung

Tools werden nicht angezeigt

1. Server-Verbindung prüfen:

   • Stellen Sie sicher, dass der Server in den Cursor-Einstellungen korrekt konfiguriert ist

   • Überprüfen Sie die Pfade in der Konfiguration

2. Cursor neu starten:

   • Starten Sie Cursor neu, damit die MCP-Konfiguration geladen wird

3. Logs überprüfen:

   • Öffnen Sie das Output-Panel in Cursor

   • Wählen Sie "MCP" oder "Model Context Protocol" aus

   • Suchen Sie nach Fehlermeldungen

4. Server manuell testen:

   • Führen Sie npm start aus

   • Der Server sollte ohne Fehler starten

Häufige Fehler

• "Cannot find module": Stellen Sie sicher, dass npm install ausgeführt wurde

• "EACCES" oder Berechtigungsfehler: Überprüfen Sie die Dateiberechtigungen

• "Command not found": Stellen Sie sicher, dass Node.js im PATH ist

Entwicklung

Neue Tools hinzufügen

Um ein neues Tool hinzuzufügen, verwenden Sie die registerTool-Methode:

server.registerTool(
  "toolName",
  {
    title: "Tool Titel",
    description: "Beschreibung des Tools",
    inputSchema: z.object({
      // Ihre Parameter hier
    }),
    outputSchema: z.object({
      // Ihre Ausgabe hier
    })
  },
  async (params) => {
    // Ihre Tool-Logik hier
    return {
      content: [{ type: "text", text: "Ergebnis" }],
      structuredContent: { /* strukturierte Daten */ }
    };
  }
);

Architektur

Der MCP-Server ist Teil einer größeren Architektur:

App
 ↓  
Connection-Key Server  ←→  MCP Server
 ↓                      ↑
n8n ←———————————————————

Komponenten:

• App: Sendet User-Wünsche

• Connection-Key Server: Zentrale API, steuert n8n + MCP

• MCP Server: Tools, KI-Agenten, Automationen (dieser Server)

• n8n: Workflows, Datenfluss, Integration, Datenverarbeitung

Kommunikation:

• Die App kommuniziert nur mit dem Connection-Key Server

• Der Connection-Key Server ruft n8n Workflows auf

• Der Connection-Key Server nutzt den MCP-Server als Agenten-Framework

• Der MCP-Server ruft n8n APIs/Webhooks auf

Beispiel-Verwendung

Beispiel 1: Human Design Reading generieren

// In Cursor können Sie jetzt sagen:
"Erstelle mir ein Human Design Reading für einen User, geboren am 1990-05-15 um 14:30 in Berlin"

Der MCP-Server ruft dann automatisch den n8n Webhook auf und generiert das Reading.

Beispiel 2: Workflow erstellen

"Erstelle einen n8n Workflow namens 'User Login Reading' mit 3 Nodes"

Beispiel 3: Partner-Matching

"Führe ein Partner-Matching zwischen User 123 und User 456 durch"

Technische Details

• Framework: @modelcontextprotocol/sdk v1.0.0+

• Schema-Validierung: Zod

• Transport: stdio (Standard Input/Output)

• Node.js: Erforderlich

• n8n Integration: Über REST API und Webhooks

• Konfiguration: Über config.js oder Umgebungsvariablen

Lizenz

Dieses Projekt ist für den persönlichen Gebrauch bestimmt.