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 — это элегантный, минималистичный и уникальный сервер Model Context Protocol (MCP), предоставляющий ИИ-ассистентам быстрый структурированный блокнот и движок контекстных заметок.

Аккуратно реализованный на официальном Python MCP SDK, QuickMemo демонстрирует все три основных примитива MCP — Инструменты, Ресурсы и Промпты — в элегантной кодовой базе без лишнего кода.

🌟 Ключевые особенности

  • ⚡ Минимализм и отсутствие лишнего кода: менее 150 строк чистого читаемого Python-кода.

  • 🎯 Все 3 примитива MCP:

    • Инструменты: сохраняйте, выводите списком, ищите, фильтруйте, получайте и удаляйте контекстные заметки.

    • Ресурсы: markdown-сводка в реальном времени (memo://all) и динамическая телеметрия (memo://stats).

    • Промпты: готовые шаблоны промптов для ревью заметок и генерации ежедневных стендапов.

  • 🔒 Никакой настройки не требуется: используется локальное постоянное JSON-хранилище (~/.quickmemo/memos.json или произвольный путь).

  • 🚀 Готовность к маркетплейсу и реестру: предварительно настроен с smithery.yaml и Dockerfile для развёртывания в один клик на Smithery и Glama.

Related MCP server: mindmap-mcp-server

📁 Структура проекта

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

📐 Обзор архитектуры

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

1. Инструменты (функции, управляемые моделью)

Tool Name

Parameters

Description

add_memo

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

Сохраняет новую заметку или фрагмент с необязательной категорией и тегами.

list_memos

category?: str, tag?: str

Выводит список сохранённых заметок с необязательной фильтрацией по категории и тегу.

get_memo

memo_id: str

Возвращает полное содержимое и метаданные конкретной заметки.

search_memos

query: str

Выполняет поиск по ключевым словам в заголовке, содержимом, тегах и категории.

delete_memo

memo_id: str

Удаляет заметку по идентификатору.

clear_memos

None

Очищает хранилище заметок.

2. Ресурсы (динамические контекстные потоки)

Resource URI

MIME Type

Description

memo://all

text/markdown

Отформатированная динамическая markdown-сводка всех сохранённых заметок.

memo://stats

application/json

Статистика в реальном времени (общее количество заметок, разбивка по категориям, распределение тегов).

3. Промпты (готовые шаблоны рабочих процессов)

Prompt Name

Arguments

Description

review_notes

category?: str

Обобщает сохранённые заметки в ключевые выводы и практический контрольный список.

daily_standup

None

Преобразует недавние заметки в стандартный ежедневный стендап-отчёт из 3 частей.

🚀 Быстрый старт и установка

Вариант 1: Локальная настройка с помощью uv (рекомендуется)

# 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

Вариант 2: Запуск напрямую через CLI

# Run server over stdio
quickmemo

🔌 Конфигурация клиента

Claude Desktop

Добавьте QuickMemo в ваш 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

Добавьте в .cursor/mcp.json в вашем рабочем пространстве:

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

☁️ Развёртывание на Smithery / Glama

Этот репозиторий предварительно настроен для реестра Smithery с помощью smithery.yaml и Dockerfile.

Установка через Smithery CLI

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

Ручное развёртывание в реестре

  1. Отправьте ваш репозиторий на GitHub.

  2. Перейдите на Smithery.ai и войдите в систему.

  3. Импортируйте ваш репозиторий GitHub. Smithery автоматически обнаружит smithery.yaml и развернёт ваш MCP-сервер.

🧪 Тестирование

Запустите автоматический набор тестов:

uv run pytest -v

Вывод:

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

📚 Материалы и учебная документация

📄 Лицензия

Лицензия 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