Skip to main content
Glama
deenesjakoruzh
Abdullah-Zafarr

quickmemo-mcp

by Abdullah-Zafarr
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

QuickMemo MCP 서버 📝⚡

Python 3.10+ MCP License: MIT Smithery Ready Tests

QuickMemo MCP는 AI 어시스턴트에게 빠르고 구조화된 스크래치패드이자 컨텍스트 메모 엔진을 제공하는 세련되고 미니멀하며 독특한 Model Context Protocol(MCP) 서버입니다.

공식 Python MCP SDK를 사용하여 깔끔하게 구축된 QuickMemo는 Tools, Resources, Prompts라는 세 가지 핵심 MCP 프리미티브를 모두 군더더기 없는 우아한 코드베이스로 보여줍니다.

🌟 주요 특징

  • ⚡ 미니멀 & 제로 블로트: 150줄 미만의 깔끔하고 읽기 쉬운 Python 코드.

  • 🎯 3가지 MCP 프리미티브 전부:

    • Tools: 컨텍스트 메모 저장, 목록, 검색, 필터, 검색, 삭제.

    • Resources: 실시간 마크다운 다이제스트(memo://all) 및 동적 원격 측정(memo://stats).

    • Prompts: 메모 검토 및 일일 스탠드업 생성을 위한 즉시 사용 가능한 프롬프트 템플릿.

  • 🔒 구성 불필요: 로컬 영구 JSON 스토리지(~/.quickmemo/memos.json 또는 사용자 지정 경로)를 사용.

  • 🚀 마켓플레이스 및 레지스트리 준비: Smithery 및 Glama에 대한 원클릭 배포를 위해 smithery.yaml 및 Dockerfile이 사전 구성되어 있음.

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. 도구(모델 제어 함수)

도구 이름

매개변수

설명

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

ID로 메모를 삭제합니다.

clear_memos

없음

메모 저장소를 비웁니다.

2. 리소스(동적 컨텍스트 스트림)

리소스 URI

MIME 유형

설명

memo://all

text/markdown

저장된 모든 메모의 형식화된 동적 마크다운 다이제스트.

memo://stats

application/json

실시간 통계(총 메모 수, 카테고리 분석, 태그 분포).

3. 프롬프트(사전 제작 워크플로 템플릿)

프롬프트 이름

매개변수

설명

review_notes

category?: str

저장된 메모를 핵심 요점과 실행 가능한 체크리스트로 종합합니다.

daily_standup

없음

최근 메모를 표준 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

claude_desktop_config.json에 QuickMemo를 추가하세요:

  • 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.yaml 및 Dockerfile을 사용하여 Smithery 레지스트리용으로 사전 구성되어 있습니다.

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 기여자.

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