Jelly Memo Local MCP Server

Jelly Memo의 사용자 기기 전용 AI 협업 서버와 Windows installer를 공개하는 저장소입니다. 한국어 안내가 먼저 나오며, English documentation은 아래에 있습니다.

한국어

무엇을 제공하나요?

• 오픈소스 Python MCP 서버
• 서버 실행·테스트 스크립트
• PyInstaller 실행 파일 빌드 정의
• Inno Setup Windows installer 빌드 정의
• 바로 설치할 수 있는 Windows installer Release

이 도구를 설치하면 MCP를 지원하는 AI 도구가 Jelly Memo의 메모를 찾고 변경을 제안할 수 있습니다. 변경 적용 여부와 자동 저장 설정은 Jelly Memo 앱에서 관리합니다.

로컬 전용·개인정보 보호

• 서버는 사용자 컴퓨터의 127.0.0.1:8765에서만 실행됩니다.
• 0.0.0.0 또는 외부 네트워크 주소로의 bind를 거부합니다.
• 서버가 Firebase, Firestore 또는 Firebase Storage에 직접 연결하지 않습니다.
• 메모 snapshot과 AI 변경 제안은 Jelly Memo 앱과 이 로컬 서버 사이에서만 교환됩니다.
• 선택적으로 pairing token을 설정해 snapshot 변경 요청을 제한할 수 있습니다.

이 저장소에는 Jelly Memo Flutter 앱 본체, Firebase 설정, 사용자 메모 또는 인증정보가 포함되지 않습니다.

가장 쉬운 설치 방법

1. 최신 Release를 엽니다.
2. JellyMemoMcpInstaller-<version>-windows-x64.exe를 다운로드합니다.
3. installer를 실행하고 Jelly Memo 설정의 AI 협업 도구에서 연결 상태를 확인합니다.

현재 installer는 Authenticode 코드 서명이 적용되지 않아 Windows SmartScreen 경고가 나타날 수 있습니다. 이 경우 다운로드한 파일과 이 저장소의 Release 출처를 직접 확인한 뒤 설치 여부를 결정하세요.

소스에서 실행하기

요구 사항: Windows, Python 3.10 이상

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"

상태 확인:

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

테스트와 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

installer 빌드에는 Inno Setup 6가 필요합니다. 산출물은 build/mcp_companion/ 아래에 생성됩니다.

오픈소스와 기여

이 로컬 MCP 서버는 MIT License로 공개됩니다. 소스를 사용·검토·수정·재배포할 수 있습니다. 버그 제보와 개선 제안은 GitHub Issues 또는 Pull Request로 보내주세요.

---

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.