convez.ai
MCP ServerProdutividadeIntermediário
adeeljames

Claude Memory MCP

adeeljames/claude-memory-mcp

Memória persistente local para Claude — 70% menos tokens

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que fornece memória persistente ao Claude entre sessões, reduzindo uso de tokens em 70% ao injetar apenas contexto relevante. Armazena e resume histórico de conversas localmente, com setup de um comando e zero latência via stdio.

Instalação

$npx convez-ai adeeljames/claude-memory-mcp

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
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Manter contexto de projetos longos sem repetir histórico completo
  • Reduzir custos de tokens em conversas recorrentes
  • Armazenar conhecimento de domínio entre múltiplas sessões

Veredito

Solução prática e leve para quem usa Claude Desktop regularmente em projetos que se estendem por múltiplas conversas. A auto-summarização mantém o contexto eficiente, mas requer integração manual na config do Claude Desktop.

README

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

🧠 Claude Memory MCP

A lightweight Model Context Protocol (MCP) server that gives Claude Desktop persistent memory across conversations. It stores, summarizes, and retrieves conversation history so Claude always remembers your context.


✨ Features

FeatureDescription
Persistent MemorySaves every conversation turn to a local memory.json file
Auto-SummarizationAutomatically compresses history after 10 turns to keep context lean
Fast Context LoadingReturns summary + last 3 turns on demand — no bloat
One-command SetupPowered by uv — no virtualenv juggling needed
Zero LatencyRuns locally over stdio — no network calls

🛠️ Tools Exposed

ToolDescription
get_contextLoad compressed memory (summary + last 3 turns). Call at the start of every conversation.
save_turnSave one conversation turn. Call after every AI response.
clear_memoryWipe all stored memory and start fresh.

🚀 Quick Start

Prerequisites

  • Python 3.13+
  • uv installed

1. Clone & Install

git clone https://github.com/adeeljames/claude-memory-mcp.git
cd claude-memory-mcp
uv sync

2. Run the MCP Server (for testing)

uv run python server.py

3. Add to Claude Desktop

Open your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the following under mcpServers:

{
  "mcpServers": {
    "memory-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/claude-mcp-optimize",
        "python",
        "server.py"
      ]
    }
  }
}

Replace /absolute/path/to/claude-mcp-optimize with the actual path on your machine.

Restart Claude Desktop — the memory-mcp server will appear in your tools list.


📁 Project Structure

claude-memory-mcp/
├── server.py           # MCP server — all tools defined here
├── memory.json         # Runtime memory file (auto-created, gitignored)
├── pyproject.toml      # uv project config & dependencies
├── uv.lock             # Locked dependency graph
└── README.md           # You are here

⚙️ How It Works

Claude Desktop ──stdio──► server.py ──► memory.json
                                          │
                         ┌────────────────┘
                         │
                    get_context()     → returns summary + last 3 turns
                    save_turn()       → appends to history, triggers summary at 10 turns
                    clear_memory()    → resets everything

🔧 Dependencies

PackagePurpose
mcp>=1.26.0Model Context Protocol SDK

All dependencies are managed by uv and pinned in uv.lock.


📄 License

MIT — free to use, modify, and share.


Made with love by @muhammadadeelai

Ver o original no GitHub

Bom para

Relacionados