por alash3al · alash3al/stash
Um pequeno serviço de memória em Go para agentes — episódios (eventos ao longo do tempo) e fatos (conhecimento durável), expostos via MCP.
Stash oferece aos agentes duas modalidades de armazenamento: episódios (eventos ordenados por tempo) e fatos (conhecimento durável chave-valor). Leve, binário único, fácil de executar em um Raspberry Pi.
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"stash-mcp": {
"command": "docker",
"args": [
"run",
"-p",
"9000:9000",
"ghcr.io/alash3al/stash:latest"
]
}
}
}Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.
{
"mcpServers": {
"stash-mcp": {
"command": "docker",
"args": [
"run",
"-p",
"9000:9000",
"ghcr.io/alash3al/stash:latest"
]
}
}
}Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.
{
"mcpServers": {
"stash-mcp": {
"command": "docker",
"args": [
"run",
"-p",
"9000:9000",
"ghcr.io/alash3al/stash:latest"
]
}
}
}Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".
{
"mcpServers": {
"stash-mcp": {
"command": "docker",
"args": [
"run",
"-p",
"9000:9000",
"ghcr.io/alash3al/stash:latest"
]
}
}
}Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.
{
"mcpServers": [
{
"name": "stash-mcp",
"command": "docker",
"args": [
"run",
"-p",
"9000:9000",
"ghcr.io/alash3al/stash:latest"
]
}
]
}O Continue usa um array de objetos de servidor em vez de um map.
{
"context_servers": {
"stash-mcp": {
"command": {
"path": "docker",
"args": [
"run",
"-p",
"9000:9000",
"ghcr.io/alash3al/stash:latest"
]
}
}
}
}Adicione em context_servers. Zed recarrega automaticamente ao salvar.
claude mcp add stash-mcp -- docker run -p 9000:9000 ghcr.io/alash3al/stash:latestUma linha só. Verifique com claude mcp list. Remova com claude mcp remove.
Quando usar: Você quer que o Claude lembre preferências e contexto recente.
Resultado: Continuidade sem pagar por um SaaS de memória completo.
Periodicamente descarregar memória em disco para backup
| Ferramenta | Entradas | Quando chamar | Custo |
|---|---|---|---|
| remember_episode | (ver docs) | Adiciona um evento à timeline | 1 chamada |
| remember_fact | (ver docs) | Armazena um fato durável | 1 chamada |
| search | (ver docs) | Pesquisa em ambos os armazenamentos | 1 chamada |
Endpoint de embedding ausenteDefina EMBEDDING_URL ou execute em modo somente palavras-chave
| Alternativa | Quando usar | Troca |
|---|---|---|
| memsearch | Você quer escala com Milvus | Setup mais pesado |