convez.ai
MCP ServerAutomaçãoAvançado
nxoim

Mycelium

nxoim/mycelium

Memória persistente associativa para agentes de IA com MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Sistema de memória persistente baseado em nós para agentes de IA, construído em Swift. Oferece armazenamento de memórias com associações contextuais, recuperação eficiente e integração via MCP (stdio e HTTP) com servidor WebSocket para observação.

Instalação

$npx convez-ai nxoim/mycelium

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
1
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Agentes que precisam manter contexto de conversas longas
  • Sistemas que aprendem e refinam conhecimento ao longo do tempo
  • Debugging assistido por IA com recuperação de contexto histórico

Veredito

Ferramenta sólida para criar agentes com memória autônoma e associativa. Exige compreensão profunda de prompts e design de sistemas para ativar efetivamente o potencial de recall contextual do modelo.

README

A tradução para o português deste README ainda está na fila.

mycelium

Simple node based memory system for AI agents built in Swift. CLI, MCP (stdio and HTTP), and observation server.

The concept

The core idea is to give LLMs a persistent, association-based memory system they can manage autonomously. Memories are presented as summaries and associated memories, for minimal impact on context window usage. The model is expected to memorize relevant information unprompted and recall it when it deems it's needed.

For example, while debugging a problem, the model might search its memory for something adjacent to the topic at hand, then find a relevant memory, then read it fully, and then shift the direction of the conversation.

The setup

Docker, Podman, etc.

See docker/README.md for build and run instructions.

Or native build

  1. Install the Swift toolchain, if you don't already have it. Make sure it's 6.3+.

  2. Build the binaries:

    scripts/build-and-package-release-macos-aarch64.sh
    
  3. Copy the output binaries from .tmp/release/ wherever you need. Prebuilt binaries are not yet published.

  4. Add the mcp to your harness. You can either launch mcp-server to host locally, or you can use the mcp-stdio binary normally.

Upon launch an sqlite memory database will be created in the folder containing the executable, unless specified otherwise via --db.

How it works in practice

With newer qwen models it works... somewhat... if directed via rules/skills. For example:

You have persistent memory.
Before each reply you should ask yourself whether you know anything about the topic of the conversation, or any of the details, and then you should try to recall any relevant information by keywords.
You should memorize anything you learn with the user, and when you memorize something you should also memorize the context - the when, the how, the why of your decision to memorize.

A memory guide can be provided for memorization to the model to help guide its memory tool usage. See MEMORY-GUIDE.md. I've found, anecdotally, that better results are achieved when memory labels are predictable, for example, by containing prefixes ("Document:", "Goal:", etc.), and when associations contain memories that act like topic tags and definitions ("Swift Programming Language", "#prefixes", etc.).

What the model sees

Memories are divided into 2 parts - summary with associations, and the full contents. Recalling a summary, individually or by searching, outputs something like:

# Label of the Memory
## Associated with:
- **Associated Memory** (id: UUID)
-- **Nested Associated Memory** (id: UUID)
-- **Nested Associated Memory** (id: UUID)
--- **Nested Associated Memory** (id: UUID)
- **Associated Memory** (id: UUID)
id: UUID

When searching, the list of memories is preceded by information about the search, like:

#### 3 memories of 12 found, starting from 0

To remember the full contents of a memory the model has access to a separate tool.

While recalling, via search or otherwise, the model can choose the depth of associations to retrieve. By default, at depth 0, direct associations are retrieved, and at depth 1 and more the associations of associations will be retrieved.

When memorizing, the associations are built omnidirectionally - between all of the provided memories.

Ver o original no GitHub

Bom para

Relacionados