AI Sticky Notes MCP Server

Ein MCP-Server, der einem KI-Assistenten ermöglicht, persönliche Notizen zu speichern, zu lesen und zusammenzufassen. Die Notizen werden in einer lokalen Datei notes.txt neben dem Server gespeichert.

Funktionen

• add_note-Tool: Hängt eine neue Notiz an.

• read_notes-Tool: Liest alle gespeicherten Notizen.

• notes://latest-Ressource: Ruft die zuletzt hinzugefügte Notiz ab.

• note_summary_prompt-Prompt: Erstellt einen Prompt, der die aktuellen Notizen für die Zusammenfassung enthält.

Related MCP server: Sticky Notes MCP Server

Voraussetzungen

• Python 3.12 oder neuer.

• pip oder uv

Lokal ausführen

Mit uv

uv sync
uv run python main.py

Mit pip

Erstellen und aktivieren Sie eine virtuelle, installieren Sie dann die Abhängigkeit:

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python main.py

Der Server kommuniziert über MCP stdio, daher wird er normalerweise von einem MCP-kompatiblen Client gestartet, statt direkt in einem Browser geöffnet zu werden.

Den Server testen

Mit installierter MCP-CLI starten Sie den MCP Inspector mit:

mcp dev main.py

Verwenden Sie den Inspector, um add_note und read_notes aufzurufen, die notes://latest-Ressource zu öffnen und note_summary_prompt auszuführen.

Sie können das Python-Modul und die Syntax direkt überprüfen:

uv run python -c "import main; print('MCP server import ok')"
uv run python -m py_compile main.py

Mit Smithery bereitstellen

Das Repository enthält smithery.yaml, das Smithery so konfiguriert, dass der Server mit folgendem Befehl gestartet wird:

startCommand:
	type: stdio
	command: python
	args: ["main.py"]

Übertragen Sie die Deployment-Dateien in ein GitHub-Repository und stellen Sie dieses Repository über Smithery bereit. Die wichtigsten Dateien sind:

• main.py

• requirements.txt

• smithery.yaml

notes.txt ist optional, da der Server sie bei Bedarf automatisch erstellt. Nehmen Sie sie nur auf, wenn Sie die Beispieldaten mitliefern möchten.

Mit Docker ausführen

Erstellen und starten Sie das enthaltene Docker-Image:

docker build -t ai-sticky-notes .
docker run --rm -i ai-sticky-notes

Projektstruktur

main.py          MCP server implementation
requirements.txt Python dependencies
smithery.yaml    Smithery stdio startup configuration
Dockerfile       Container build configuration
notes.txt        Local note storage, created automatically if absent

Hinweis zur Speicherung

Die Notizen werden in einer reinen Textdatei gespeichert. Das ist für die lokale Nutzung und Vorführungen geeignet, aber in gehosteten Containern kann die Datei bei Neustarts oder erneuten Bereitstellungen möglicherweise erhalten bleiben. Für eine dauerhafte Produktionsspeicherung sollten Sie eine externe Datenbank oder ein persistentes Volume verwenden.