Jelly Memo Local MCP Server

Dieses Repository veröffentlicht den lokal auf dem Gerät des Benutzers laufenden KI-Kollaborationsserver für Jelly Memo sowie den Windows-Installer. Die deutsche Anleitung finden Sie zuerst; die englische Dokumentation finden Sie darunter.

Deutsch

Was ist enthalten?

• Open-Source-Python-MCP-Server

• Skripte zum Ausführen und Testen des Servers

• PyInstaller-Builddefinition für die ausführbare Datei

• Inno-Setup-Builddefinition für den Windows-Installer

• Sofort installierbare Windows-Installer-Releases

Nach der Installation dieses Tools können MCP-kompatible KI-Tools Jelly-Memo-Notizen finden und Änderungen vorschlagen. Die Jelly-Memo-App verwaltet, ob Änderungen übernommen und automatisch gespeichert werden.

Lokaler Betrieb und Datenschutz

• Der Server läuft ausschließlich auf 127.0.0.1:8765 auf dem Computer des Benutzers.

• Das Binden an 0.0.0.0 oder eine andere externe Netzwerkadresse wird abgelehnt.

• Der Server verbindet sich nicht direkt mit Firebase, Firestore oder Firebase Storage.

• Memo-Snapshots und KI-Änderungsvorschläge werden nur zwischen der Jelly-Memo-App und diesem lokalen Server ausgetauscht.

• Optional kann ein Pairing-Token eingerichtet werden, um Snapshot-Änderungsanfragen einzuschränken.

Dieses Repository enthält weder die Jelly-Memo-Flutter-App selbst noch Firebase-Konfiguration, Benutzernotizen oder Anmeldedaten.

Die einfachste Installation

1. Öffnen Sie das neueste Release.

2. Laden Sie JellyMemoMcpInstaller-<version>-windows-x64.exe herunter.

3. Führen Sie den Installer aus und prüfen Sie in den Jelly-Memo-Einstellungen unter KI-Kollaborationstools den Verbindungsstatus.

Der Installer ist derzeit nicht mit einer Authenticode-Codesignatur versehen, daher kann Windows SmartScreen eine Warnung anzeigen. Prüfen Sie in diesem Fall die heruntergeladene Datei und die Quelle des Releases in diesem Repository selbst, bevor Sie über die Installation entscheiden.

Aus dem Quellcode ausführen

Voraussetzungen: Windows und Python 3.10 oder neuer

git clone https://github.com/egm7126/simpleMemo-releases.git
cd simpleMemo-releases
py -3.10 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .
.\scripts\run_companion.ps1 -PythonPath ".\.venv\Scripts\python.exe"

Status prüfen:

Invoke-RestMethod http://127.0.0.1:8765/health

Tests und Windows-Installer-Build

.\.venv\Scripts\python.exe -m unittest discover -s tests -v
.\.venv\Scripts\python.exe -m compileall jellymemo_mcp_companion tests
.\.venv\Scripts\python.exe -m pip install -e ".[build]"
.\packaging\build_server.ps1 -PythonPath ".\.venv\Scripts\python.exe"
.\packaging\build_installer.ps1

Für den Build des Installers wird Inno Setup 6 benötigt. Die Build-Ausgaben werden unter build/mcp_companion/ erstellt.

Open Source und Beiträge

Dieser lokale MCP-Server wird unter der MIT License veröffentlicht. Sie können den Quellcode verwenden, einsehen, ändern und weiterverteilen. Fehlermeldungen und Verbesserungsvorschläge senden Sie bitte über GitHub Issues oder Pull Requests.

Related MCP server: memopaper-mcp

English

This repository publishes the local AI collaboration server for Jelly Memo, together with its Windows installer releases.

What is included?

• Open-source Python MCP server

• Server run and test scripts

• PyInstaller executable build definition

• Inno Setup Windows installer definition

• Ready-to-install Windows installer releases

Once installed, MCP-compatible AI tools can find Jelly Memo notes and propose changes. Jelly Memo controls whether proposals are applied and saved automatically.

Local-only privacy model

• The server listens only on 127.0.0.1:8765 on the user's computer.

• Binding to 0.0.0.0 or another external network address is rejected.

• The server does not connect directly to Firebase, Firestore, or Firebase Storage.

• Memo snapshots and AI proposals are exchanged only between Jelly Memo and this local server.

• An optional pairing token can restrict snapshot mutation requests.

This repository does not contain the Jelly Memo Flutter application, Firebase configuration, user notes, or credentials.

Easiest installation

1. Open the latest Release.

2. Download JellyMemoMcpInstaller-<version>-windows-x64.exe.

3. Run the installer and check the connection under AI collaboration tools in Jelly Memo settings.

The installer is currently not Authenticode-signed, so Windows SmartScreen may display a warning. Verify the downloaded file and its GitHub Release source before choosing whether to install it.

Run from source

Requirements: Windows and Python 3.10 or newer

git clone https://github.com/egm7126/simpleMemo-releases.git
cd simpleMemo-releases
py -3.10 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .
.\scripts\run_companion.ps1 -PythonPath ".\.venv\Scripts\python.exe"

Check server health:

Invoke-RestMethod http://127.0.0.1:8765/health

Test and build the Windows installer

.\.venv\Scripts\python.exe -m unittest discover -s tests -v
.\.venv\Scripts\python.exe -m compileall jellymemo_mcp_companion tests
.\.venv\Scripts\python.exe -m pip install -e ".[build]"
.\packaging\build_server.ps1 -PythonPath ".\.venv\Scripts\python.exe"
.\packaging\build_installer.ps1

Building the installer requires Inno Setup 6. Build outputs are written under build/mcp_companion/.

Open source and contributing

This local MCP server is available under the MIT License. You may use, inspect, modify, and redistribute the source. Bug reports and improvements are welcome through GitHub Issues and Pull Requests.