
MaxGraph
Self-hosted persistent memory for AI agents: knowledge graph and hybrid search.
Connector by RuMemory · GitHub account verified by the MCP Registry
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.
About
Reviews
Write a reviewNo 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_timelineread_graphsearch_nodestask_donetask_list
Write 7 · Create, change, send or run things.
add_observationscreate_entitiescreate_relationssession_closesession_starttask_addupdate_entity
Delete 4 · Delete, drop, revoke or wipe things.
delete_entitiesdelete_observationsdelete_observations_by_iddelete_relations
Not yet classified 3 · We could not tell from the name and description.
demote_from_globalopen_nodespromote_to_global
Network hosts it talks to 6
agent-plugins.org· found in codeapple.com· found in codecounter.yadro.ru· found in codegithub.com· found in codelocalhost.evil.tld· found in coderezon-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_observationsAdd 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_entitiesCreate 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_relationsCreate multiple relations. Active voice only: "uses", "depends on", "configured by" — не "is used by". project: kebab-slug проекта (события пульса получат его метку).
delete_entitiesDelete multiple entities and their associated relations from the knowledge graph. project: kebab-slug — удаляются только сущности этого проекта
delete_observationsDelete 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_relationsDelete 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_timelineList recent memory events (audit log): what was created/updated and when. project: kebab-slug — только события этого проекта; all_projects=true — явно все
open_nodesOpen 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_graphRead the knowledge graph. Вызывай ПЕРВЫМ на старте сессии — это твоя долгосрочная память о проекте и пользователе. project: kebab-slug — только этот проект (+ сущность project:<slug>); all_projects=true — явный кросс-поиск по всем; без параметров — весь граф, как раньше.
search_nodesSearch 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_entityUpdate 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
- Repository
- github.com/RuMemory/maxgraph
- Website
- rezon-ai.ru
- 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)