---
slug: "advanced-memory-mcp"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/sandraschi/advanced-memory-mcp@master/README.md"
repo: "https://github.com/sandraschi/advanced-memory-mcp"
source_file: "README.md"
branch: "master"
---
[![FastMCP Version](https://img.shields.io/badge/FastMCP-3.2%20GA%20(namespaces)-blue?style=flat-square&logo=python&logoColor=white)](https://github.com/jlowin/fastmcp) [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff) [![Linted with Biome](https://img.shields.io/badge/Linted_with-Biome-60a5fa?style=flat-square&logo=biome&logoColor=white)](https://biomejs.dev/) [![Built with Just](https://img.shields.io/badge/Built_with-Just-000000?style=flat-square&logo=gnu-bash&logoColor=white)](https://github.com/casey/just)

![Advanced Memory Hub](https://github.com/sandraschi/advanced-memory-mcp/raw/HEAD/docs/assets/header.png)

# Advanced Memory (Memops)

<p align="center">
  <a href="https://github.com/casey/just"><img src="https://img.shields.io/badge/just-ready_to_go-7c5cfc?style=flat-square&logo=just&logoColor=white" alt="Just"></a>
  <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a>
  <a href="https://python.org"><img src="https://img.shields.io/badge/Python-3.13+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python"></a>
  <a href="https://biomejs.dev"><img src="https://img.shields.io/badge/Linted_with-Biome-60a5fa?style=flat-square&logo=biome&logoColor=white" alt="Biome"></a>
  <a href="https://github.com/PrefectHQ/fastmcp"><img src="https://img.shields.io/badge/FastMCP-3.2-7c5cfc?style=flat-square" alt="FastMCP"></a>
</p>


> 📖 **[Installation Guide](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/INSTALL.md)** — quick start, manual setup, and troubleshooting

- **Why** — Give an MCP-capable assistant a **durable place** for notes, research, and retrieval: search and RAG over *your* content instead of losing context every session.
- **What** — A **FastMCP 3.2 GA** server (Python 3.12+) exposing **79 tools across 12 Industrial Portmanteaus** (`audio`, `inbox`, `skills`, `zettel`, `nav`, `notes`, `search`, `knowledge`, `project`, `system`, `mcp`, `typora`). Optimized with **2026 Industrial Docstrings** (Rationale-First) and **Discriminated Unions** for high-fidelity tool selection in Antigravity/Cursor.
- **How** — **Connect** the MCP server from your client ([installation](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/docs/INSTALLATION.md), then [usage](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/docs/USAGE.md)). Optionally run the **[webapp](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/webapp/README.md)** for a browser UI on top of the same backend.

---

## Quick Start

```powershell
git clone https://github.com/sandraschi/advanced-memory-mcp
cd advanced-memory-mcp
just
```

This opens an interactive dashboard showing all available commands. Run `just bootstrap` to install dependencies, then `just serve` or `just dev` to start.

### Manual Setup

If you don't have `just` installed:

## Documentation

- [Installation](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/docs/INSTALLATION.md) — Python `uv`, optional OCR/Pandoc
- [Usage](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/docs/USAGE.md) — MCP clients, webapp, advanced topics
- [AI features](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/docs/AI-FEATURES.md) — RAG, agentic mode, sampling
- [FastMCP 3.2](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/docs/FASTMCP.md) — Managed Namespaces, prefabs, CodeMode, transports
- [Product requirements (PRD)](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/docs/PRD.md) — current mission, scope, KPIs (1.8.x)
- [Architecture](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/docs/ARCHITECTURE.md)
- [Fleet / multi-node](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/docs/FLEET.md)
- [Compliance & standards](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/docs/COMPLIANCE_AND_STANDARDS.md)
- [Development](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/docs/DEVELOPMENT.md) — `just` recipes (lint, test, pack)
- [Changelog](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/CHANGELOG.md)
- [Release checklist (MCPB + Git tag)](https://github.com/sandraschi/advanced-memory-mcp/blob/HEAD/docs/operations/RELEASE_CHECKLIST.md)

---

## 日本語 (Japanese)

**Advanced Memory (Memops)** は、AIコーディングエージェントのための永続的な知識グラフ＆Zettelkastenメモリシステムです。セッションをまたいで知識を保持し、検索・RAG・ノート・スキル管理・音声操作などを提供します。

- **12のポートマントーツール、79の操作** — `adn_search`（全文検索＋RAG）、`adn_notes`（ノートCRUD）、`adn_zettel`（Zettelkasten生成・分析）、`adn_skills`（スキル管理）、`adn_audio`（音声認識・合成）など
- **デュアルトランスポート** — stdio（Claude Desktop / Cursor）＋ HTTP/SSE（Webダッシュボード）
- **ローカルファースト** — SQLite + LanceDBベクトル検索、外部API不要
- **Claude Codeフック対応** — セッション開始時に自動リコール（`.claude-plugin/`）

📖 クイックスタート: `git clone` → `just bootstrap` → `just serve`

日本語での詳細ドキュメントは [docs/ja/](https://github.com/sandraschi/advanced-memory-mcp/tree/HEAD/docs/ja/) をご覧ください。

---

**Author:** Sandra Schipal · Vienna, Austria


## 🛡️ Industrial Quality Stack

This project adheres to **SOTA 14.1** industrial standards for high-fidelity agentic orchestration:

- **Python (Core)**: [Ruff](https://astral.sh/ruff) for linting and formatting. Zero-tolerance for `print` statements in core handlers (`T201`).
- **Webapp (UI)**: [Biome](https://biomejs.dev/) for sub-millisecond linting. Strict `noConsoleLog` enforcement.
- **Protocol Compliance**: Hardened `stdout/stderr` isolation to ensure crash-resistant JSON-RPC communication.
- **Automation**: [Justfile](https://github.com/sandraschi/advanced-memory-mcp/tree/HEAD/justfile) recipes for all fleet operations (`just lint`, `just fix`, `just dev`).
- **Security**: Automated audits via `bandit` and `safety`.