https://claude.ai/chat/4dea4e6a-4f62-44b0-8a96-f87167a17fef https://claude.ai/public/artifacts/8f2db72a-f062-4d0c-b64c-e7f4018910d6

cloudflared tunnel --url http://localhost:3001

• E-Mail: test@example.com

• Passwort: password123

PocketBase Task MCP-Server

Ein Model Context Protocol (MCP) Server, der sich in PocketBase integriert, um Aufgaben und Projekte zu verwalten. Dieser Server ermöglicht es KI-Modellen (wie Claude), Aufgaben zu erstellen, Aufgaben mit Statusfiltern aufzulisten und Projekte zu durchsuchen.

Läuft jetzt über HTTP – Einfach lokal zu testen und bereit für die Bereitstellung!

Funktionen

• HTTP-Transport: Einfacher URL-basierter Zugriff, keine komplexe Konfiguration erforderlich

• Tool-Verkettung: Verknüpft Aufgaben automatisch mit Projekten, indem zuerst die IDs abgerufen werden

• Projektverwaltung: Alle Projekte aus der projects-Sammlung auflisten

• Aufgabenverwaltung: Aufgaben in der task-Sammlung mit obligatorischen Projektbeziehungen erstellen

• Statusfilterung: Aufgaben auflisten und nach dem Status 'Pending' (Ausstehend) oder 'Completed' (Abgeschlossen) filtern

• Umgebungsgesteuert: Sicher verwaltet über eine .env-Datei für die PocketBase-Authentifizierung

• Einfaches Testen: Einfacher Health-Check-Endpunkt und Unterstützung für den MCP Inspector

⚡ Schnellstart

# 1. Install dependencies
npm install

# 2. Create .env file
echo "PB_AUTH_TOKEN=your_super_admin_token_here" > .env

# 3. Build the project
npm run build

# 4. Start the server
node dist/index.js

Ihr Server läuft jetzt unter http://localhost:3000!

Testen Sie es: Öffnen Sie http://localhost:3000/health in Ihrem Browser.

🚀 Erste Schritte

1. Voraussetzungen

• Node.js (v18+)

• PocketBase, das lokal unter http://127.0.0.1:8090 läuft

• Ein PocketBase Super-Admin-Token.

2. Installation

npm install

3. Konfiguration

Erstellen Sie eine .env-Datei im Projektstammverzeichnis:

PB_AUTH_TOKEN=your_super_admin_token_here

🛠️ Entwicklung & Debugging

Projekt erstellen

Kompilieren Sie den TypeScript-Code in JavaScript:

npm run build

HTTP-Server starten

Starten Sie den Server lokal:

node dist/index.js

Der Server startet unter http://localhost:3000 (oder dem in Ihrer .env-Datei angegebenen Port).

Sie sollten eine Ausgabe wie diese sehen:

MCP server running on http://localhost:3000
Health check: http://localhost:3000/health
MCP endpoint: http://localhost:3000/mcp

Server testen

Besuchen Sie den Health-Check-Endpunkt in Ihrem Browser:

http://localhost:3000/health

Sie sollten Folgendes sehen:

{"status":"ok","message":"PMS MCP Server is running"}

Optionale Port-Konfiguration

Fügen Sie dies Ihrer .env-Datei hinzu, um den Port zu ändern:

PORT=3000
PB_AUTH_TOKEN=your_super_admin_token_here

📖 Verfügbare Tools

• list_projects: Alle Projekte und deren IDs abrufen.

• create_task: Eine neue Aufgabe erstellen (erfordert task_title, eta, status und project_id).

• list_tasks: Alle Aufgaben mit optionaler Statusfilterung auflisten.

🧪 Testen der Tools

Sie können den MCP-Server mit dem MCP Inspector oder durch eine Verbindung über den HTTP-Endpunkt unter http://localhost:3000/mcp testen.

Verwendung des MCP Inspectors

npx @modelcontextprotocol/inspector

Verbinden Sie sich dann mit: http://localhost:3000/mcp

🌐 Warum HTTP statt Stdio?

Vorteile:

• Keine Konfigurationsdateien: Es ist nicht erforderlich, claude_desktop_config.json oder andere komplexe Konfigurationen zu bearbeiten

• Einfaches Testen: Einfacher URL-Zugriff über Browser oder Tools wie Postman

• Remote-bereit: Kann auf einem Server bereitgestellt und von überall aufgerufen werden

• Mehrere Clients: Mehrere Anwendungen können gleichzeitig eine Verbindung herstellen

• Besseres Debugging: Einfache Überwachung von Anfragen und Antworten mit Standard-HTTP-Tools

Verbindung von MCP-Clients:

Wenn Sie MCP-kompatible Clients verwenden, verbinden Sie sich mit:

http://localhost:3000/mcp

📝 Abhängigkeiten

• @modelcontextprotocol/sdk: Kern-MCP-Funktionalität

• pocketbase: PocketBase JS SDK

• express: HTTP-Server-Framework

• cors: Cross-Origin Resource Sharing Middleware

• zod: Schema-Validierung

• dotenv: Verwaltung von Umgebungsvariablen