Jelly Memo Local MCP Server

Jelly Memoのユーザー端末専用AIコラボレーションサーバーとWindowsインストーラーを公開するリポジトリです。 日本語の案内が先にあり、English documentationは下にあります。

日本語

何を提供しますか？

• オープンソースPython MCPサーバー

• サーバー実行・テストスクリプト

• PyInstaller実行ファイルビルド定義

• Inno Setup Windowsインストーラービルド定義

• すぐにインストールできるWindowsインストーラーリリース

このツールをインストールすると、MCPをサポートするAIツールがJelly Memoのメモを検索し、変更を提案できるようになります。変更の適用有無と自動保存設定はJelly Memoアプリで管理します。

ローカル専用・プライバシー保護

• サーバーはユーザーのコンピューターの127.0.0.1:8765でのみ実行されます。

• 0.0.0.0または外部ネットワークアドレスへのbindを拒否します。

• サーバーはFirebase、Firestore、Firebase Storageに直接接続しません。

• メモのスナップショットとAI変更提案は、Jelly Memoアプリとこのローカルサーバー間でのみ交換されます。

• オプションでペアリングトークンを設定して、スナップショット変更リクエストを制限できます。

このリポジトリには、Jelly Memo Flutterアプリ本体、Firebase設定、ユーザーメモまたは認証情報は含まれません。

最も簡単なインストール方法

1. 最新のReleaseを開きます。

2. JellyMemoMcpInstaller-<version>-windows-x64.exeをダウンロードします。

3. インストーラーを実行し、Jelly Memo設定のAIコラボレーションツールで接続状態を確認します。

現在のインストーラーは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インストーラービルド

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

インストーラービルドにはInno Setup 6が必要です。成果物はbuild/mcp_companion/の下に生成されます。

オープンソースと貢献

このローカルMCPサーバーはMIT Licenseで公開されています。ソースを使用・検討・修正・再配布できます。バグ報告と改善提案はGitHub IssuesまたはPull Requestでお送りください。

Related MCP server: Bruin

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.