Jelly Memo Local MCP Server

Этот репозиторий публикует локальный AI-сервер совместной работы для личных устройств Jelly Memo и установщик Windows. Сначала идёт инструкция на корейском, а английская документация находится ниже.

Корейский

Что предоставляется?

• Открытый Python MCP-сервер

• Скрипты запуска и тестирования сервера

• Определение сборки исполняемого файла PyInstaller

• Определение сборки установщика Windows на базе Inno Setup

• Готовый к установке релиз установщика Windows

После установки этого инструмента AI-инструменты с поддержкой MCP смогут находить заметки Jelly Memo и предлагать изменения. Применение изменений и настройки автоматического сохранения управляются в приложении Jelly Memo.

Только локальный режим и конфиденциальность

• Сервер запускается только на 127.0.0.1:8765 на компьютере пользователя.

• Привязка к 0.0.0.0 или другому внешнему сетевому адресу отклоняется.

• Сервер не подключается напрямую к Firebase, Firestore или Firebase Storage.

• Снимки заметок и AI-предложения изменений передаются только между приложением Jelly Memo и этим локальным сервером.

• При желании можно настроить токен сопряжения, чтобы ограничить запросы на изменение снимков.

Этот репозиторий не содержит само приложение Jelly Memo на Flutter, конфигурацию Firebase, пользовательские заметки или учётные данные.

Самый простой способ установки

1. Откройте последний релиз.

2. Скачайте файл JellyMemoMcpInstaller-<version>-windows-x64.exe.

3. Запустите установщик и проверьте статус подключения в разделе AI-инструменты совместной работы в настройках Jelly Memo.

В настоящее время установщик не имеет код-подписи Authenticode, поэтому Windows SmartScreen может показывать предупреждение. В таком случае проверьте скачанный файл и источник релиза в этом репозитории, прежде чем решать, устанавливать ли его.

Запуск из исходного кода

Требования: 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. Вы можете использовать, просматривать, изменять и распространять исходный код. Сообщения об ошибках и предложения по улучшению отправляйте через GitHub Issues или Pull Request.

Related MCP server: Bruin

English

Этот репозиторий публикует локальный AI-сервер совместной работы для Jelly Memo вместе с релизами установщика Windows.

Что входит?

• Открытый Python MCP-сервер

• Скрипты запуска и тестирования сервера

• Определение сборки исполняемого файла PyInstaller

• Определение установщика Windows на базе Inno Setup

• Готовые к установке релизы установщика Windows

После установки AI-инструменты, совместимые с MCP, смогут находить заметки Jelly Memo и предлагать изменения. Jelly Memo управляет тем, применяются ли предложения и сохраняются ли они автоматически.

Локальная модель конфиденциальности

• Сервер прослушивает только адрес 127.0.0.1:8765 на компьютере пользователя.

• Привязка к 0.0.0.0 или другому внешнему сетевому адресу отклоняется.

• Сервер не подключается напрямую к Firebase, Firestore или Firebase Storage.

• Снимки заметок и AI-предложения передаются только между Jelly Memo и этим локальным сервером.

• Опциональный токен сопряжения может ограничивать запросы на изменение снимков.

Этот репозиторий не содержит приложение Jelly Memo на Flutter, конфигурацию Firebase, пользовательские заметки или учётные данные.

Самый простой способ установки

1. Откройте последний релиз.

2. Скачайте JellyMemoMcpInstaller-<version>-windows-x64.exe.

3. Запустите установщик и проверьте подключение в разделе AI-инструменты совместной работы в настройках Jelly Memo.

Установщик в настоящее время не подписан Authenticode, поэтому Windows SmartScreen может показывать предупреждение. Проверьте скачанный файл и его источник в GitHub 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. Вы можете использовать, просматривать, изменять и распространять исходный код. Сообщения об ошибках и улучшения приветствуются через GitHub Issues и Pull Requests.