Skip to main content
Glama
deenesjakoruzh
Abdullah-Zafarr

quickmemo-mcp

by Abdullah-Zafarr
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

QuickMemo MCP Server 📝⚡

Python 3.10+ MCP License: MIT Smithery Ready Tests

QuickMemo MCP ist ein eleganter, minimalistischer und einzigartiger Model Context Protocol (MCP)-Server, der KI-Assistenten eine schnelle, strukturierte Notiz- und Kontext-Memo-Engine bietet.

Sauber mit dem offiziellen Python MCP SDK gebaut, präsentiert QuickMemo alle drei zentralen MCP-Primitive – Tools, Resources und Prompts – in einer eleganten, aufgeräumten Codebasis ohne Ballast.

🌟 Wichtigste Highlights

  • ⚡ Minimalistisch & ohne Ballast: Unter 150 Zeilen sauberer, lesbarer Python-Code.

  • 🎯 Alle 3 MCP-Primitive:

    • Tools: Kontext-Memos speichern, auflisten, durchsuchen, filtern, abrufen und löschen.

    • Resources: Echtzeit-Markdown-Übersicht (memo://all) und dynamische Telemetrie (memo://stats).

    • Prompts: Fertige Prompt-Vorlagen für Notiz-Reviews und die Erstellung täglicher Standups.

  • 🔒 Keine Konfiguration erforderlich: Verwendet lokalen persistenten JSON-Speicher (~/.quickmemo/memos.json oder benutzerdefinierter Pfad).

  • 🚀 Marktplatz- & Registry-bereit: Vorkonfiguriert mit smithery.yaml und Dockerfile für die Ein-Klick-Bereitstellung auf Smithery und Glama.

Related MCP server: mindmap-mcp-server

📁 Projektstruktur

quickmemo-mcp/
├── docs/                               # Learning documentation & reports
│   ├── EXISTING_MCP_EXPERIENCE.md      # Hands-on write-up evaluating Context7 & Playwright
│   └── MCP_FUNDAMENTALS.md             # Complete MCP protocol & architecture guide
├── src/
│   └── quickmemo/                      # MCP Server package (<150 LOC)
│       ├── __init__.py                 # Package exports
│       ├── __main__.py                 # Executable entrypoint
│       └── server.py                   # Core server (Tools, Resources, Prompts)
├── tests/
│   ├── demo_client.py                  # Live interactive demonstration script
│   └── test_server.py                  # Pytest unit & integration test suite
├── Dockerfile                          # Containerized deployment manifest
├── LICENSE                             # MIT License
├── pyproject.toml                      # Package configuration & dependencies
├── README.md                           # Quickstart & user documentation
└── smithery.yaml                       # Smithery registry manifest

📐 Architekturübersicht

+-------------------------------------------------------------------------------+
|                                  MCP CLIENT                                   |
|             (Claude Desktop / Cursor IDE / Antigravity / Custom AI)           |
+-------------------------------------------------------------------------------+
                                       ▲
                                       │ JSON-RPC 2.0 (stdio)
                                       ▼
+-------------------------------------------------------------------------------+
|                             QUICKMEMO MCP SERVER                              |
|                                                                               |
|   [TOOLS]                     [RESOURCES]                 [PROMPTS]           |
|   • add_memo                  • memo://all (Digest)       • review_notes      |
|   • list_memos                • memo://stats (JSON)       • daily_standup     |
|   • search_memos                                                              |
|   • get_memo / delete_memo                                                    |
+-------------------------------------------------------------------------------+
                                       │
                                       ▼
                         Local JSON Storage Engine
                         (~/.quickmemo/memos.json)

🛠️ MCP-Primitive-Katalog

1. Tools (Modellgesteuerte Funktionen)

Tool-Name

Parameter

Beschreibung

add_memo

title: str, content: str, category?: str, tags?: list[str]

Speichert ein neues Memo oder einen Ausschnitt mit optionaler Kategorie und Tags.

list_memos

category?: str, tag?: str

Listet gespeicherte Memos mit optionaler Kategorie- und Tag-Filterung auf.

get_memo

memo_id: str

Ruft vollständigen Inhalt und Metadaten für ein bestimmtes Memo ab.

search_memos

query: str

Führt eine Stichwortsuche über Titel, Inhalt, Tags und Kategorie durch.

delete_memo

memo_id: str

Löscht ein Memo anhand der ID.

clear_memos

Keine

Leert den Memo-Speicher.

2. Resources (Dynamische Kontext-Streams)

Resource-URI

MIME-Typ

Beschreibung

memo://all

text/markdown

Formatierte dynamische Markdown-Übersicht aller gespeicherten Memos.

memo://stats

application/json

Echtzeit-Statistiken (Gesamtzahl der Memos, Kategorien-Aufschlüsselung, Tag-Verteilung).

3. Prompts (Vorgefertigte Workflow-Vorlagen)

Prompt-Name

Argumente

Beschreibung

review_notes

category?: str

Fasst gespeicherte Memos zu wichtigen Erkenntnissen und einer umsetzbaren Checkliste zusammen.

daily_standup

Keine

Wandelt aktuelle Memos in einen standardmäßigen 3-teiligen täglichen Standup-Bericht um.

🚀 Schnellstart & Installation

Option 1: Lokale Einrichtung mit uv (Empfohlen)

# Clone the repository
git clone https://github.com/your-username/quickmemo-mcp.git
cd quickmemo-mcp

# Install dependencies and package in editable mode
uv pip install -e .

# Run test suite
uv run pytest -v

# Run the interactive demo
uv run python tests/demo_client.py

Option 2: Direkt über die CLI ausführen

# Run server over stdio
quickmemo

🔌 Client-Konfiguration

Claude Desktop

Fügen Sie QuickMemo zu Ihrer claude_desktop_config.json hinzu:

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

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quickmemo": {
      "command": "uvx",
      "args": ["--from", "quickmemo", "quickmemo"]
    }
  }
}

Cursor IDE

Fügen Sie in Ihrem Workspace Folgendes zu .cursor/mcp.json hinzu:

{
  "mcpServers": {
    "quickmemo": {
      "command": "quickmemo"
    }
  }
}

☁️ Bereitstellung auf Smithery / Glama

Dieses Repository ist für die Smithery-Registry mit smithery.yaml und Dockerfile vorkonfiguriert.

Installation über die Smithery-CLI

npx -y @smithery/cli install quickmemo --client claude

Manuelle Registry-Bereitstellung

  1. Übertragen Sie Ihr Repository auf GitHub.

  2. Besuchen Sie Smithery.ai und melden Sie sich an.

  3. Importieren Sie Ihr GitHub-Repository. Smithery erkennt smithery.yaml automatisch und stellt Ihren MCP-Server bereit.

🧪 Tests

Führen Sie die automatisierte Testsuite aus:

uv run pytest -v

Ausgabe:

tests/test_server.py::TestMemoStore::test_add_and_get PASSED             [ 12%]
tests/test_server.py::TestMemoStore::test_list_and_filter PASSED         [ 25%]
tests/test_server.py::TestMemoStore::test_search PASSED                  [ 37%]
tests/test_server.py::TestMemoStore::test_delete_and_clear PASSED        [ 50%]
tests/test_server.py::TestServerTools::test_tool_workflow PASSED         [ 62%]
tests/test_server.py::TestServerTools::test_clear_memos_tool PASSED      [ 75%]
tests/test_server.py::TestServerResourcesAndPrompts::test_resources PASSED [ 87%]
tests/test_server.py::TestServerResourcesAndPrompts::test_prompts PASSED [100%]

============================== 8 passed in 1.10s ==============================

📚 Lieferumfang & Lerndokumentation

📄 Lizenz

MIT-Lizenz © 2026 QuickMemo MCP-Mitwirkende.

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • hithereiamaliff-mcp-nextcloud

    A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • ContextLattice

    Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.

  • Reasoning Commons

    AI Reasoning Cache & Consensus Layer with 11 MCP tools via Streamable HTTP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Abdullah-Zafarr/quickmemo-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server