SkillAgentSearch skills...

noosphere-lite-mcp

Local-first MCP long-term memory for AI agents with knowledge graphs, provenance, history and stale-fact tracking.

Install / Use

claude mcp add Garyu-tt -- npx -y github:Garyu-tt/noosphere-lite-mcp

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

73/100

Supported Platforms

Claude Code
Claude Desktop

Our assessment of noosphere-lite-mcp

noosphere-lite-mcp scores 73/100 on our quality scale, 3740th of 4,650 Development & Engineering skills we index.

Its MCP Server is 13 KB long, well organised into 23 sections and no code examples: a thorough specification that gives an agent plenty to work with.

It has 10 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
13/20
Description
12/15
Adoption
4/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated today, so noosphere-lite-mcp is actively maintained.
  • It is released under GPL-3.0, a copyleft license: you can use it, but modified versions you distribute must carry the same license.
  • Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

noosphere-lite-mcp compared with similar skills

All 4 of these similar skills score higher than noosphere-lite-mcp; compare them before choosing.

SkillScoreStarsUpdatedFormat
noosphere-lite-mcp (this skill)by Garyu-tt7310todayMCP Server
taste-skillby Leonxlnx100112.1ktodayCLAUDE.md
Agent-Reachby Panniantong100110.4k1d agoCLAUDE.md
rufloby ruvnet10081.3ktodayCLAUDE.md
headroomby headroomlabs-ai10079.2k1d agoCLAUDE.md

Frequently asked questions

How do I install noosphere-lite-mcp?
Run claude mcp add Garyu-tt -- npx -y github:Garyu-tt/noosphere-lite-mcp. The install tabs above show the steps for each supported agent.
Which AI agents does noosphere-lite-mcp work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is noosphere-lite-mcp safe to use?
It is GPL-3.0-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is noosphere-lite-mcp still maintained?
The repository was last updated today, so noosphere-lite-mcp is actively maintained.

Noosphere Lite MCP

Память для ИИ, которой не нужно помещаться в контекстное окно.

Автор — Garyu-tt · Версия 0.3.0 · Linux / Python / MCP · GNU GPLv3

English documentation


Что это вообще такое?

Представь: ты несколько недель разрабатываешь проект с нейросетью. Вы находите ошибки, принимаете решения, меняете архитектуру, проверяете гипотезы. А потом начинается новый диалог, и половину проделанной работы приходится объяснять заново.

Noosphere Lite — долговременная память, которая живёт отдельно от агента. Это не ещё одна языковая модель, не бесконечный чат и не каталог текстовых файлов. Это хранилище знаний, их истории и взаимосвязей. Агент подключается к нему через MCP, получает ровно ту информацию, которая нужна в текущий момент, и продолжает работу.

Память принадлежит не конкретной сессии. Один агент сохранил решение сегодня; другой может найти его через неделю. Не нужно пытаться запихнуть в промпт весь архив: контекстное окно становится рабочим столом, а не складом.

Что умеет Lite

Память по требованию

У агента есть несколько способов вспомнить необходимое: найти подходящие записи, получить краткие результаты, прочитать одну запись целиком, пройти по связанным узлам или собрать ограниченный объём контекста под задачу. Всё остальное в контекст не попадает.

Граф вместо мешка заметок

Каждая запись — отдельный узел: идентификатор, заголовок, текст, тип, теги, ссылка на источник и время изменений. Узлы можно связывать именованными направленными отношениями: например, related, supports, blocks, derived_from.

По графу можно ходить на глубину от одного до трёх переходов. Содержимое записей не обязано загружаться вместе с картой связей. Можно сначала найти путь, а затем открыть нужный узел.

Каскадное устаревание

Это важнее, чем кажется. Если однажды сохранённый факт изменился, старые выводы, построенные на нём, нельзя продолжать выдавать как актуальные.

Пример:

Измерение A
   ↑ derived_from
Вывод B
   ↑ derived_from
Решение C

Если пересмотреть A, Lite автоматически пометит B и C как stale — «требует повторной проверки». Если явно признать A недостоверным, устареет вся цепочка: A, B и C. История при этом остаётся на месте.

Система не пытается самостоятельно придумать новую истину и не удаляет неудобные результаты. Она честно сообщает агенту: «этот вывод опирался на сведения, которые уже изменились».

Каскад работает по явным связям derived_from. Lite пока не угадывает такие зависимости самостоятельно. Статус current означает «не помечено устаревшим», а не «достоверность доказана».

История изменений

Ноосфера не должна забывать, почему возникло то или иное решение. Новые изменения записываются событиями, а предыдущие состояния остаются в истории. Даже архивация не уничтожает старую запись из зашифрованного журнала — лишь скрывает её из обычной выдачи.

Поэтому память подходит не только для хранения ответов, но и для накопления опыта: наблюдение → вывод → решение → пересмотр.

Хранение: отдельно граф, отдельно события

Внутри Lite четыре слоя:

ИИ-агент
    │ MCP-запрос
    ▼
Поиск и выборка контекста
    │
    ▼
Рабочий граф в оперативной памяти
    │
    ▼
Зашифрованный журнал событий
    ├─ основная копия
    └─ зеркальная копия

В постоянном хранилище используется собственный бинарный журнал NLV1, зашифрованный с AES-256-GCM. В нём последовательно фиксируются события: создание записи, связь, изменение, устаревание, архивация.

Рабочий граф восстанавливается в оперативной памяти. Постоянного открытого JSON-файла с полезными данными или незашифрованного поискового индекса нет.

Это сознательно простой движок: поиск пока лексический, а не векторный. С версии 0.3.0 есть экспериментальный read-only поиск возможных связей между уже сохранёнными заметками; он не подтверждает факты и не создаёт связи автоматически. Эмбеддинги, нейронное извлечение смысла и автоматическое понимание противоречий — направления развития, а не функции версии 0.3.0.

Защита и две копии

Каждое событие аутентифицируется и связывается с предыдущим через хеш. Изменение или повреждение журнала обнаруживается при чтении. Две копии сверяются; если одна повреждена или отстала, её можно восстановить по исправной.

По умолчанию копии должны находиться на разных файловых системах. Ключ шифрования хранится отдельно, с доступом только владельцу. Ключ тоже необходимо безопасно резервировать: потеря всех его экземпляров означает потерю доступа ко всей памяти.

Два зеркала не заменяют независимую внешнюю резервную копию. А если злоумышленник получил доступ к работающей пользовательской сессии и ключу, шифрование диска уже не решает проблему за тебя.

Универсальный интерфейс

Lite работает локально на Linux и не требует облака, GPU или собственной нейросети. Агент получает память через MCP. В комплекте локальный сервер stdio, без открытого HTTP-порта, запуска команд и доступа к произвольным файлам компьютера.

Это память для совместимого агента, а не агент, который тайком управляет системой.

Как это выглядит в работе

Ты сохранил решение о конфигурации сервера и связал его с исходным тестом. Через месяц новый агент возвращается к проекту: находит решение, открывает его источник и связанные заметки, восстанавливает ход мысли.

А если исходный тест за это время оказался неправильным, все выводы, которые явно от него зависели, уже будут помечены для перепроверки.

Смысл не в том, чтобы помнить больше текста. Смысл — не терять причинно-следственные связи между уже проделанными действиями.

Установка на Linux

Нужен Python 3.11 или новее.

git clone https://github.com/Garyu-tt/noosphere-lite-mcp.git
cd noosphere-lite-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Подключи две независимые файловые системы под хранилище и настрой пути:

export NSL_PRIMARY=/mnt/storage-a/noosphere-lite
export NSL_MIRROR=/mnt/storage-b/noosphere-lite
export NSL_KEY_FILE="$HOME/.config/noosphere-lite/key"

python -m noosphere_lite init
python -m noosphere_lite status
python -m noosphere_lite mcp

Каталоги хранилища должны иметь права 0700; ключ и журналы — 0600. Инициализация не перезаписывает существующие журналы.

Только для тестов на одном диске можно указать переменную NSL_DEVELOPMENT_SAME_DEVICE=1. Это отключает проверку независимости копий и не подходит для ценных данных.

Настройка MCP-клиента

Для клиентов, поддерживающих локальный stdio MCP, пример конфигурации:

{
  "mcpServers": {
    "noosphere-lite": {
      "command": "/absolute/path/noosphere-lite-mcp/.venv/bin/python",
      "args": ["-m", "noosphere_lite", "mcp"],
      "env": {
        "NSL_PRIMARY": "/mnt/storage-a/noosphere-lite",
        "NSL_MIRROR": "/mnt/storage-b/noosphere-lite",
        "NSL_KEY_FILE": "/home/you/.config/noosphere-lite/key"
      }
    }
  }
}

Это пример для совместимых локальных MCP-хостов. Интерфейс ChatGPT может требовать отдельно поддерживаемый мост; конфигурация stdio сама по себе не устанавливает облачный коннектор.

Зашифрованные брифинги и карточки файлов (R02)

Новые инструменты memory_briefing и memory_by_source работают непосредственно с уже зашифрованными журналами NLV1, без создания открытого поискового индекса. Для выборки заметок укажи явный тег project:my-app и тип negative, invariant, open_loop, decision или fact. Поиск по пути сравнивает только сохранённую строку source; он не читает исходник и не подтверждает его актуальность. Подтверждение совпадения с JSON-источником выполняется существующим Evidence Gate, но оно не доказывает истинность факта. Теги проекта — фильтр, а не система прав доступа.

18 инструментов MCP

| Инструмент | Что делает | | --- | --- | | memory_add | Сохраняет заметку, факт, решение или задачу | | memory_search | Ищет подходящие воспоминания | | memory_suggest_links | Предлагает непроверенные связи по пересечению значимых терминов и тегов; ничего не записывает | | memory_read | Возвращает конкретную запись целиком | | memory_context | Собирает ограниченный контекст для задачи | | memory_link / memory_unlink | Создаёт и удаляет типизированные связи | | memory_neighborhood | Обходит соседние узлы | | memory_revise | Обновляет запись и помечает зависимые выводы как устаревшие | | memory_invalidate | Запускает каскадное устаревание от выбранной записи | | memory_archive | Скрывает запись, не стирая историю | | memory_status | Проверяет журналы и статистику | | memory_evidence_source_add / memory_evidence_propose | Записывает источник JSON и предлагает проверяемое по нему, но ещё не подтверждённое утверждение | | memory_evidence_reject / memory_evidence_context | Фиксирует отклонения, выдаёт только согласованные с источниками кандидаты и показывает противоречия | | memory_briefing | Собирает ограничения, незавершённую работу и факты по проекту в рамках зашифрованной памяти | | memory_by_source | Находит карточки по точной строке пути исходника, не обращаясь к файловой системе |

Эксперимент: обучаемые веса связей (R04)

В каталоге examples/reviewed_plasticity опубликован отдельный Python-пример весов графа с независимым подтверждением результатов, SHA-256 доказательств, разреженным накоплением полезности и откатом. Это opt-in reference implementation, не функция ядра Lite 0.3.0: оно не изменяет зашифрованные NLV1-журналы и не обучает веса LLM. Для реальной работы нужен доверенный интегратор с аутентификацией агентов и QA; его SQLite-sidecar хранит метаданные без шифрования.

Эксперимент: проверяемая временная память (R01)

В examples/memory_synthesis опубликована отдельная экспериментальная реализация привязки фактов к исходным файлам, SHA-256/Git, времени действия утверждений, безопасного явного вытеснения старых версий, проверки цитат, негативных правил, коротких брифингов и FTS5-поиска. Каталог 27 исследовательских идей сохраняет атрибуцию и ограничения лицензий Agents Remember, Daimon, Primnox и Engram.

Это не часть зашифрованного ядра Lite 0.3.0: пример использует незашифрованный SQLite и не предназначен для приватных данных. Внутренние форумы, агенты, секреты и административные функции профессиональной версии в публичный репозиторий не переносятся.

Чего пока нет

В дальнейших версиях хочется добавить автоматическое обнаружение зависимостей, векторный и семантический поиск, уровни значимости памяти, управление давностью и сроками хранения, согласование конфликтующих источников, уплотнение истории, разделение прав между агентами и внешние резервные копии.

В 0.3.0 этого пока нет. Текущий движок рассчитан на один хост и одного пишущего процесса с блокировкой, а не на распределённый кластер. Журнал при запросах перечитывается, поэтому большие базы потребуют отдельной оптимизации. Текущий лимит — 150 000 событий, а не 150 000 узлов.

Проверка

python -m unittest discover -s tests -v

Тесты покрывают шифрование, обнаружение повреждений, восстановление копии, связи и многоуровневое каскадное устаревание. Подключение локального MCP-клиента проверено на синтетических данных.


Noosphere Lite MCP — чтобы новый разговор не означал новое начало.

Garyu-tt · GNU GPLv3 · English documentation

License / Authorship

Original project code in this release: GNU GPL-3.0-or-later. Copyright (C) 2026 Garyu-tt. See LICENSE and AUTHORS.md. Previously published MIT-licensed versions retain their earlier permissions and existing contributors' acknowledgments.

Контекст с проверкой источника R02 (2026-11-08)

Результаты обычного

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars10
CategoryDevelopment
Updated1h ago
Forks1

Languages

Python

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info