MCP Project

Quote Collection MCP-Server

Ein MCP-Server (Model Context Protocol) für eine persönliche Zitate-Sammlung. Ermöglicht es, Zitate zu speichern, zu kategorisieren und gezielt oder zufällig wiederzufinden – direkt aus Claude oder anderen MCP-fähigen Clients heraus.

Tech-Stack

TypeScript (Node16-Module, strikter Modus) Node.js MCP SDK (Model Context Protocol) Persistierung als JSON-Datei

Funktionen

add_quote – einzelnes Zitat hinzufügen search_quotes – Zitate nach Text, Autor, Thema oder Sprache durchsuchen (case-insensitive) random_quote – zufälliges Zitat abrufen delete_quote – Zitat anhand der ID löschen import_quotes – mehrere Zitate per Batch-Import einspielen

Alle Funktionen (Hinzufügen, Suchen, zufälliges Abrufen, Löschen, Batch-Import) sind getestet und funktionsfähig.

Installation & Start

npm install npm run build node build/index.js

Der Server meldet sich beim Start mit Quote Collection MCP-Server läuft... und ist anschließend über das MCP-Protokoll ansprechbar (z. B. über Claude Desktop, durch Eintragen in dessen Konfigurationsdatei).

Was ich dabei gelernt habe

Aufbau eines MCP-Servers von der Spezifikation bis zum lauffähigen Tool Strukturierung eines TypeScript-Projekts mit striktem Compiler-Modus (strict: true, Node16-Modulauflösung) Design eines einfachen, dateibasierten Persistenz-Layers (JSON) inkl. Datenmodell für Zitate Implementierung case-insensitiver Suche über mehrere Felder hinweg

Hintergrund

Entstanden als Projekt im Rahmen der Ausbildung zur AI Mobile App Developer (AppAkademie), mit AI-First-Ansatz in der Entwicklung.