Skip to content
Agentmart
Submit a tool

MaxGraph

Self-hosted persistent memory for AI agents: knowledge graph and hybrid search.

Connector by RuMemory · GitHub account verified by the MCP Registry

IndexedLicense unknownRemote (HTTP)★ 3
Write a review

Install

Pick your client. Read the repository before you give any tool access to your data.

No install instructions from the source yet. Check the repository for setup steps.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Self-hosted persistent memory for AI agents: knowledge graph and hybrid search.

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
5 read · 7 write · 4 delete · 3 not yet classified
Secrets
None asked for
Install scripts
None found
Runs as
Docker image

Tools by what they do 19

Read from the source code; the running server may list different tools.

Read 5 · Look things up without changing anything.

  • list_timeline
  • read_graph
  • search_nodes
  • task_done
  • task_list

Write 7 · Create, change, send or run things.

  • add_observations
  • create_entities
  • create_relations
  • session_close
  • session_start
  • task_add
  • update_entity

Delete 4 · Delete, drop, revoke or wipe things.

  • delete_entities
  • delete_observations
  • delete_observations_by_id
  • delete_relations

Not yet classified 3 · We could not tell from the name and description.

  • demote_from_global
  • open_nodes
  • promote_to_global

Network hosts it talks to 6

  • agent-plugins.org · found in code
  • apple.com · found in code
  • counter.yadro.ru · found in code
  • github.com · found in code
  • localhost.evil.tld · found in code
  • rezon-ai.ru · found in code

Files it touches

  • ~/.claude
  • ~/.claude/settings.json
  • ~/.maxgraph/empty.npmrc
  • ~/.maxgraph/hooks.env
  • /etc/machine-id
  • /sys/class/dmi/id/board_serial
  • /sys/class/dmi/id/product_uuid
  • /var/lib/dbus/machine-id
  • Your home directory (~)
  • ~/.codeium/windsurf
  • ~/.codeium/windsurf/hooks.json
  • ~/.codex
  • ~/.codex/hooks.json
  • ~/.cursor
  • ~/.cursor/hooks.json
  • ~/.dsh/dsh-runtimes/dsh-primary-runtime
  • ~/.dsh/dsh-runtimes/dsh-primary-runtime/runtime.json
  • ~/.dsh/profiles
  • ~/.gemini/antigravity
  • ~/.gemini/antigravity-cli
  • ~/.gemini/config
  • ~/.gemini/config/hooks.json
  • ~/.gemini/settings.json
  • ~/.kimi-code
  • ~/.kimi-code/config.toml
  • ~/.maxgraph/bridge-repair-last
  • ~/.maxgraph/hooks.json
  • ~/.maxgraph/maxgraph_hook.py
  • ~/.maxgraph/recalled.json
  • ~/.maxgraph/spool.jsonl

Tools (19)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • add_observations

    Add new observations to existing entities. Одно наблюдение = один атомарный факт (с датой, если важно). Пиши СРАЗУ, как узнал, — не в конце разговора. Факт УСТАРЕЛ (цена, версия, решение) — не удаляй и не дублируй: передай старую строку в supersedes того же item (пометится [~дата] и уйдёт из поиска/session_start, оставшись в архиве; вернуть — update_entity(restore=[...]); физически удалить можно всегда — delete_observations). Ненайденные строки — в supersedesNotFound ответа. contents: элемент — строка или {"text": "...", "source": {"kind": "commit"|"file"|"url"|"issue", "ref": "..."}} (1.6.0; …

  • create_entities

    Create multiple new entities in the knowledge graph. name = kebab-case id навсегда (не меняется), title = человеческое имя. Сначала search_nodes — не дублируй существующие. entityType: канонические project/session/bug/decision/request/event/task (синонимы RU/EN канонизируются: bugfix→bug, решение→decision, просьба→request, задача→task; свободный тип сохраняется как есть); bug получает status open/fixed, task — open/done (default open). project: kebab-slug проекта — сущность project:<slug> создаётся автоматически, существующее имя в чужом проекте → warning без merge.

  • create_relations

    Create multiple relations. Active voice only: "uses", "depends on", "configured by" — не "is used by". project: kebab-slug проекта (события пульса получат его метку).

  • delete_entities

    Delete multiple entities and their associated relations from the knowledge graph. project: kebab-slug — удаляются только сущности этого проекта

  • delete_observations

    Delete specific observations from entities in the knowledge graph. project: kebab-slug — затрагиваются только сущности этого проекта

  • delete_observations_by_id

    Точечный forget по id наблюдения. items: [{entity, ids}] — id бери из выдачи search_nodes/open_nodes с with_ids=true (id стабилен: sha256 текста как хранится, включая [~дата]-маркер). Ответ: results[] с deleted/notFound по каждой сущности; отсутствующая сущность — errors[]. project: kebab-slug — затрагиваются только сущности этого проекта

  • delete_relations

    Delete multiple relations from the knowledge graph. project: kebab-slug — удаляются только связи с обоими концами в этом проекте

  • demote_from_global

    Вернуть сущность из спецпроекта global в указанный проект (project ОБЯЗАТЕЛЕН, kebab-slug назначения). Симметричен promote_to_global: меняется только поле project (+updatedAt, событие пульса demote_global); коллизия имени в проекте назначения → merge ({"merged": true}).

  • list_timeline

    List recent memory events (audit log): what was created/updated and when. project: kebab-slug — только события этого проекта; all_projects=true — явно все

  • open_nodes

    Open specific nodes in the knowledge graph by their names. project: kebab-slug — видимы только сущности этого проекта. with_ids=true: observations — объекты {id, text} для delete_observations_by_id; default false — старый формат строк

  • promote_to_global

    Перенести сущность в спецпроект global: её decision-факты видны в session_start ЛЮБОГО проекта (секция «Глобальная память»). Запись в global — только явная (этот инструмент или project="global" у create_entities/add_observations). Перенос меняет только поле project (+updatedAt, событие пульса): наблюдения/теги/тип/связи сохраняются. Коллизия имени в global → merge наблюдений с дедупом по тексту (ответ {"merged": true}). project: kebab-slug текущего проекта сущности — сущность вне него считается ненайденной; без project — любой проект, кроме global.

  • read_graph

    Read the knowledge graph. Вызывай ПЕРВЫМ на старте сессии — это твоя долгосрочная память о проекте и пользователе. project: kebab-slug — только этот проект (+ сущность project:<slug>); all_projects=true — явный кросс-поиск по всем; без параметров — весь граф, как раньше.

  • search_nodes

    Search for nodes by query. Используй вместо read_graph, когда нужна одна тема, и ПЕРЕД create_entities — чтобы не создать дубликат. project: kebab-slug — искать только в этом проекте; all_projects=true — явный кросс-поиск. type: фильтр по типу после нормализации (канонические: project/session/bug/decision/request/event/task; «bugfix»/«баг» → bug; свободный тип — точное совпадение). Непустой query — ранжированный FTS-lite: сортировка по релевантности, limit — топ-N (default 20), у сущностей ответа + score, snippet, highlights (позиции совпадений в snippet, без HTML); часто и недавно читаемые су…

  • session_close

    Закрыть сессию дня ОДНИМ вызовом (вызывай в конце сессии): session-сущность дня создаётся или домердживается (в т.ч. в stub от SessionEnd-хука), summary + done становятся наблюдениями, links получают связи "discussed". links не передан → связи собираются механически из сегодняшнего пульса (без LLM, ничего не пишется за тебя — только по твоему явному вызову). Повторный вызов за день — домердж, а не новая сущность. Ответ: session (имя), merged, already_closed, linked, links_auto, links_skipped (неизвестные имена), open_tasks_hint (открытые задачи, тронутые сегодня — закрой через task_done, если …

  • session_start

    ВЫЗЫВАЙ ПЕРВЫМ на старте сессии: бюджетный блок контекста проекта — {context_block, meta}. context_block готов к вставке в промпт: # Проект → ## Решения владельца (decision, дословно) → ## Открытые баги (bug, не закрытые) → ## Открытые задачи (task, status≠done — дела на потом) → ## Глобальная память (decision-сущности спецпроекта global — общие для всех проектов знания; 1.7.0) → ## Прошлые сессии (session, имя + 2 факта) → ## Недавние события. Внутри решений/багов/задач порядок — актуальность: свежесть × частота обращений (ACT-R). Жёсткий бюджет budget_chars (default 10000): блок никогда его …

Show 4 more tools
  • task_add

    Добавить открытое дело «на потом» (work_state): создаёт task-сущность task-<slug(title)> со status=open (коллизия имени → суффикс -2). note — первый факт (опционально: контекст, ссылка). links — имена связанных сущностей (баг, решение, сессия): связи «relates to» создаются в том же вызове, неизвестные имена → links_skipped. Пока задача открыта, она попадает в секцию «Открытые задачи» session_start. Закрытие — task_done (само свяжет задачу к сессии дня). project: kebab-slug проекта.

  • task_done

    Закрыть задачу: status=done + событие task_done в пульс. Только entityType=task; уже закрытая — идемпотентно (already: true). project: kebab-slug — задачи чужого проекта считаются ненайденными.

  • task_list

    Открытые задачи (status≠done), recency-first — что сейчас висит в работе. project: kebab-slug — только этот проект; без project — все открытые задачи графа. Операция чтения (пульс не пишется).

  • update_entity

    Update title, type, tags or status of an existing entity. entityType канонизируется (синонимы RU/EN → project/session/bug/decision/request/event/task; свободный тип — как есть). status — для bug (open/fixed) и task (open/done); для остальных типов — игнор с warning в ответе. restore: снять маркер [~дата] с наблюдений (откат supersedes) — строки с маркером или без; ненайденные — в restoreNotFound. project: kebab-slug — сущности чужого проекта считаются ненайденными

Signals

Stars
3
Forks
1
Open issues
0
Last commit
Oct 23, 2026 (5 days ago)
Last release
Oct 23, 2026 (5 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.RuMemory/maxgraph
Version
1.9.5
Auth
API key
Packages
oci ghcr.io/rumemory/maxgraph:1.9.5
License
License unknown
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Cite this page

MaxGraph MCP server. Agent Mart. https://agentmart.dev/connectors/rumemory-maxgraph (last updated 2026-10-24)