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 es un servidor de Model Context Protocol (MCP) elegante, minimalista y único que proporciona a los asistentes de IA un bloc de notas rápido y estructurado y un motor de notas de contexto.

Construido limpiamente con el SDK oficial de Python para MCP, QuickMemo muestra las tres primitivas MCP principales—Herramientas, Recursos y Prompts—en un código elegante y sin bloat.

🌟 Características Principales

  • ⚡ Minimalista y Sin Bloat: Menos de 150 líneas de código Python limpio y legible.

  • 🎯 Las 3 Primitivas MCP:

    • Herramientas: Guarda, lista, busca, filtra, recupera y elimina notas de contexto.

    • Recursos: Resumen markdown en tiempo real (memo://all) y telemetría dinámica (memo://stats).

    • Prompts: Plantillas de prompt listas para usar para revisiones de notas y generación de reuniones diarias.

  • 🔒 Sin Configuración Requerida: Utiliza almacenamiento JSON local persistente (~/.quickmemo/memos.json o ruta personalizada).

  • 🚀 Listo para Marketplace y Registro: Preconfigurado con smithery.yaml y Dockerfile para un despliegue con un solo clic en Smithery y Glama.

Related MCP server: mindmap-mcp-server

📁 Estructura del Proyecto

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

📐 Visión General de la Arquitectura

+-------------------------------------------------------------------------------+
|                                  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)

🛠️ Catálogo de Primitivas MCP

1. Herramientas (Funciones Controladas por el Modelo)

Nombre de la herramienta

Parámetros

Descripción

add_memo

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

Guarda una nueva nota o fragmento con categoría y etiquetas opcionales.

list_memos

category?: str, tag?: str

Lista las notas guardadas con filtrado opcional por categoría y etiqueta.

get_memo

memo_id: str

Recupera el contenido completo y los metadatos de una nota específica.

search_memos

query: str

Realiza una búsqueda por palabras clave en título, contenido, etiquetas y categoría.

delete_memo

memo_id: str

Elimina una nota por su ID.

clear_memos

None

Vacía el almacén de notas.

2. Recursos (Flujos de Contexto Dinámicos)

URI del recurso

Tipo MIME

Descripción

memo://all

text/markdown

Resumen markdown dinámico y formateado de todas las notas guardadas.

memo://stats

application/json

Estadísticas en tiempo real (total de notas, desglose por categorías, distribución de etiquetas).

3. Prompts (Plantillas de Flujo de Trabajo Predefinidas)

Nombre del prompt

Argumentos

Descripción

review_notes

category?: str

Sintetiza las notas guardadas en conclusiones clave y una lista de verificación accionable.

daily_standup

None

Convierte las notas recientes en un informe estándar de reunión diaria en 3 partes.

🚀 Inicio Rápido e Instalación

Opción 1: Configuración Local con uv (Recomendado)

# 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

Opción 2: Ejecución Directa mediante CLI

# Run server over stdio
quickmemo

🔌 Configuración del Cliente

Claude Desktop

Añade QuickMemo a tu claude_desktop_config.json:

  • 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

Añade a .cursor/mcp.json en tu espacio de trabajo:

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

☁️ Despliegue en Smithery / Glama

Este repositorio está preconfigurado para el registro Smithery con smithery.yaml y Dockerfile.

Instalar mediante la CLI de Smithery

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

Despliegue Manual en el Registro

  1. Sube tu repositorio a GitHub.

  2. Visita Smithery.ai e inicia sesión.

  3. Importa tu repositorio de GitHub. Smithery detecta automáticamente smithery.yaml y despliega tu servidor MCP.

🧪 Pruebas

Ejecuta la suite de pruebas automatizada:

uv run pytest -v

Salida:

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 ==============================

📚 Entregables y Documentación de Aprendizaje

📄 Licencia

Licencia MIT © 2026 QuickMemo MCP Contributors.

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