regret-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
regret-mcp
A tiny local MCP memory server that stores lessons learned and resurfaces them before your AI agent repeats the same mistake.
π― 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:
Fork the repo
Create a feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
π License
MIT Β© 2026 β See LICENSE for details.
If this project helped you, please β star it!
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
Related MCP Connectors
Hosted memory for AI agents over MCP. One memory shared by all your agents.
Persistent memory, knowledge graph, task management and more for AI agents via MCP.
Shared memory for your AI tools: tasks, notes and context every tool can read and write over MCP.
Persistent, inspectable memory for AI agents with lineage, correction, and a hosted MCP endpoint.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceA local-first MCP memory server providing persistent, searchable memory for AI agents, powered by SQLite.1Functional Source , Version 1.1, ALv2 Future
- AlicenseNot gradedqualityDmaintenancePersistent 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 npm2MIT
- AlicenseAqualityDmaintenanceA 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.8AGPL 3.0
- AlicenseAqualityDmaintenanceA 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.6MIT