mcp-memo-server

Ein einfacher MCP-Server zur Notizverwaltung, der von Claude Code aus verwendet werden kann. Es ist eine Beispielimplementierung für Lernzwecke. Er unterstützt eine einfache Benutzerauthentifizierung (Benutzerregistrierung / Login / Sitzungstoken) und Notizen werden pro Benutzer getrennt.

Bereitgestellte Werkzeuge

Notizen werden in memos.json (im Projektverzeichnis) und Benutzerinformationen in users.json gespeichert. Beide sind in .gitignore enthalten.

Funktionsweise der Authentifizierung (Lernpunkte)

• Passwörter werden mit dem Node.js-Standard crypto.scrypt mit Salt gehasht und in users.json gespeichert (keine Klartextspeicherung).

• Nach erfolgreichem login wird ein zufälliges Sitzungstoken ausgegeben. Das Token wird nur im Speicher des Serverprozesses verwaltet, hat eine Gültigkeit von 2 Stunden und verfällt bei einem Neustart des Servers.

• add_memo / list_memos / delete_memo validieren das token und geben einen Fehler zurück, wenn keine gültige Sitzung vorhanden ist.

• list_memos / delete_memo filtern die Notizen nach der mit dem Token verknüpften userId, sodass die Notizen anderer Benutzer nicht sichtbar sind.

Hinweis: Dies ist eine Authentifizierungsimplementierung für Lernzwecke über den stdio-Transport (lokaler Prozess). Bei stdio hat man bereits Ausführungsrechte für den Prozess, sobald man den Server starten kann. Daher geht es hier weniger um eine „echte Sicherheitsgrenze“, sondern darum, „mehrere Benutzer zu unterscheiden“ und „die Implementierung eines Authentifizierungsablaufs zu lernen“.

Related MCP server: memos-mcp-server

Einrichtung

npm install
npm run build

Registrierung bei Claude Code

Nach dem Build registrieren Sie mit dem absoluten Pfad des Projekts.

claude mcp add --transport stdio memo-server -- node /絶対パス/mcp-memo-server/build/index.js

Überprüfen, ob die Registrierung erfolgreich war:

claude mcp list

Wenn Sie in einer Claude-Code-Sitzung /mcp eingeben, können Sie überprüfen, dass memo-server als connected angezeigt wird.

Beispiel für die Verwendung (Konversation in Claude Code)

> ユーザー名 taro、パスワード pass1234 で登録して
> taro でログインして
> 「Qiitaのネタを考える」というメモを追加して
> 今登録されているメモを一覧で見せて
> ID 1 のメモを削除して

Das beim Login ausgegebene Token wird von Claude im Gespräch gespeichert und automatisch für spätere Aufrufe von add_memo / list_memos / delete_memo wiederverwendet.

Manuelle Funktionsprüfung

test-client.mjs ist ein einfaches Skript, das JSON-RPC-Nachrichten (initialize → tools/list → tools/call) direkt an den als untergeordneten Prozess gestarteten Server sendet und die Antworten überprüft.

node test-client.mjs

Zum Entfernen

claude mcp remove memo-server