Jelly Memo Local MCP Server

Este repositorio publica el servidor de colaboración de IA exclusivo para el dispositivo del usuario de Jelly Memo y el instalador de Windows.

La guía en español aparece primero, y la documentación en inglés está más abajo.

Español

¿Qué ofrece?

• Servidor MCP de Python de código abierto

• Scripts de ejecución y prueba del servidor

• Definición de compilación del ejecutable PyInstaller

• Definición de compilación del instalador de Windows con Inno Setup

• Versión del instalador de Windows lista para instalar

Al instalar esta herramienta, las herramientas de IA compatibles con MCP pueden buscar notas de Jelly Memo y proponer cambios. La aplicación Jelly Memo gestiona si los cambios se aplican y si se guardan automáticamente.

Solo local y protección de datos personales

• El servidor se ejecuta solo en 127.0.0.1:8765 en el ordenador del usuario.

• Se rechaza la vinculación a 0.0.0.0 o a cualquier otra dirección de red externa.

• El servidor no se conecta directamente a Firebase, Firestore ni Firebase Storage.

• Las instantáneas de notas y las propuestas de cambios de IA solo se intercambian entre la aplicación Jelly Memo y este servidor local.

• Opcionalmente, se puede configurar un token de emparejamiento para restringir las solicitudes de modificación de instantáneas.

Este repositorio no contiene la aplicación Flutter de Jelly Memo, la configuración de Firebase, las notas del usuario ni las credenciales.

La forma más fácil de instalar

1. Abra la última versión.

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

3. Ejecute el instalador y compruebe el estado de la conexión en Herramientas de colaboración de IA de la configuración de Jelly Memo.

Actualmente, el instalador no tiene firma de código Authenticode, por lo que Windows SmartScreen puede mostrar una advertencia. En ese caso, verifique directamente el archivo descargado y el origen de la versión de este repositorio antes de decidir si instalarlo.

Ejecutar desde el código fuente

Requisitos: Windows y Python 3.10 o superior

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"

Comprobar el estado:

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

Pruebas y compilación del instalador de Windows

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

La compilación del instalador requiere Inno Setup 6. Los resultados se generan en build/mcp_companion/.

Código abierto y contribución

Este servidor MCP local se publica bajo la Licencia MIT. Se puede usar, revisar, modificar y redistribuir el código fuente. Envíe informes de errores y sugerencias de mejora a través de GitHub Issues o 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.