# 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.