Skip to main content
Glama
regret-mcp

regret-mcp

by yulinlina

regret-mcp

A tiny local MCP memory server that stores lessons learned and resurfaces them before your AI agent repeats the same mistake.

License Language Status PyPI Python MCP


🎯 Why?

Trending repos focus on agent memory, agent skills, and autonomous coding agents, but most memory systems are vector stores, hosted services, or heavyweight frameworks. Developers need a zero-dependency local memory primitive for explicit post-mortems: task, mistake, correction, tags. regret-mcp fills that gap with a small SQLite-backed MCP server and CLI that can be attached to Claude Code or any MCP client in seconds.

Target audience: Developers using Claude Code, Cursor, or custom MCP agents who want persistent local memory; agent framework authors needing a simple lesson-memory tool; DevOps and platform teams capturing operational lessons.

Related MCP server: apex-memory

✨ Features

  • ✨ MCP stdio server exposing add_lesson, search_lessons, list_lessons, forget_lesson, and stats tools

  • ✨ Local SQLite storage with tag normalization, severity levels, and keyword search

  • ✨ CLI for adding, searching, listing, forgetting, and inspecting lessons without an MCP client

πŸš€ Quick Start

# Install
pip install regret-mcp

# Run
regret-mcp --help

πŸ“¦ Installation

From Source

git clone https://github.com/YOUR_USERNAME/regret-mcp.git
cd regret-mcp
# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest -v

🎬 Demo

The GIF above was recorded using Charm VHS:

vhs < demo.tape

πŸ“– Usage

# Show help
regret-mcp --help

# Common usage examples
regret-mcp --example

πŸ—οΈ Architecture

graph LR
    A[Input] --> B[Core Engine]
    B --> C[Output]
    B --> D[Plugins]
    D --> E[Extensions]

🀝 Contributing

Contributions are welcome! Please:

  1. Fork the repo

  2. Create a feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

πŸ“„ License

MIT Β© 2026 β€” See LICENSE for details.


If this project helped you, please ⭐ star it!

Made with ❀️ and AI

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      A local-first MCP memory server providing persistent, searchable memory for AI agents, powered by SQLite.
      1
      Functional Source , Version 1.1, ALv2 Future
    • A
      license
      Not graded
      quality
      D
      maintenance
      Persistent memory for AI coding agents. Enables agents to save and recall decisions, patterns, bugs, and context across sessions via an MCP server with local SQLite storage.
      9 npm
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A local-first memory engine for AI agents with MCP-native, graph-linked, spaced repetition. It enables agents to log, retrieve, and manage learnings via CLI or MCP server.
      8
      AGPL 3.0
    • A
      license
      A
      quality
      D
      maintenance
      A lightweight, local-first MCP server and CLI that helps developers and AI coding agents store and retrieve lessons learned during development, using SQLite and context-aware filtering.
      6
      MIT