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 という 3 つの主要な MCP プリミティブ すべてを、エレガントで無駄のないコードベースで紹介しています。

🌟 主な特長

  • ⚡ ミニマル＆ゼロブロート: 150 行未満のクリーンで読みやすい Python コード。

  • 🎯 3 つすべての MCP プリミティブ:

    • Tools: コンテキストメモの保存、一覧表示、検索、フィルタリング、取得、削除。

    • Resources: リアルタイムの Markdown ダイジェスト (memo://all) と動的テレメトリ (memo://stats)。

    • Prompts: メモのレビューやデイリースタンドアップ生成のための、すぐに使えるプロンプトテンプレート。

  • 🔒 設定不要: ローカルの永続 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. Tools (モデル制御関数)

ツール名

パラメータ

説明

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. Resources (動的コンテキストストリーム)

リソース URI

MIME タイプ

説明

memo://all

text/markdown

保存されているすべてのメモの、フォーマットされた動的 Markdown ダイジェスト。

memo://stats

application/json

リアルタイム統計 (メモ総数、カテゴリ別内訳、タグ分布)。

3. Prompts (事前構築済みワークフローテンプレート)

プロンプト名

引数

説明

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 License © 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