Skip to main content
Glama
MCP Notes Server

MCP Notes Server

by truaxki

MCP ノートサーバー

鍛冶屋のバッジ

永続ストレージを使用してメモを管理するためのモデル コンテキスト プロトコル (MCP) サーバー実装。

特徴

  • メモの作成、閲覧、更新、削除

  • JSONを使用した永続ストレージ

  • 作成と変更のタイムスタンプ追跡

  • プロンプトによるメモの要約

  • note:// URIスキームを使用したリソースベースのアクセス

Related MCP server: Beeper MCP Note Server

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop のノートを自動的にインストールするには:

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

手動インストール

  1. Python 3.10以降がインストールされていることを確認してください

  2. 仮想環境を作成します。

    python -m venv .venv
    
    # On Unix/MacOS:
    source .venv/bin/activate
    
    # On Windows:
    .venv\Scripts\activate
  3. インストール要件:

    pip install MCP

プロジェクト構造

notes/
├── __init__.py          # Package initialization
├── server.py           # Main server implementation
├── storage.py          # Note persistence layer
├── resources.py        # Resource handling (note:// URIs)
├── prompts.py         # LLM prompt generation
└── tools/             # Server tools
    ├── __init__.py    # Tools package initialization
    ├── list_tools.py  # Tool listing functionality
    └── handle_tools.py # Tool handling implementation

利用可能なツール

  • add-note : 新しいメモを作成する

  • list-all-notes : 保存されているすべてのメモを表示する

  • update-note : 既存のノートを変更する

  • delete-note : メモを削除する

使用法

  1. サーバーを起動します。

    mcp install src/notes
    mcp start Notes
  2. 操作例:

    # Create a note
    await client.call_tool("add-note", {
        "name": "example",
        "content": "This is a test note"
    })
    
    # List all notes
    await client.call_tool("list-all-notes")
    
    # Update a note
    await client.call_tool("update-note", {
        "name": "example",
        "content": "Updated content"
    })
    
    # Delete a note
    await client.call_tool("delete-note", {
        "name": "example"
    })

ストレージ

メモは次の構造でnotes_storage.jsonに保存されます。

{
    "note_name": {
        "content": "Note content",
        "created_at": "2025-01-12T11:28:16.721704",
        "modified_at": "2025-01-12T11:28:16.721704"
    }
}

リソースアクセス

ノートにはnote:// URI スキームを使用してリソースとしてアクセスできます。

  • リソースの一覧表示: 利用可能なすべてのノートをリソースとして返します

  • リソースの読み取り: note://internal/note_nameを使用して特定のノートにアクセスします。

プロンプト生成

サーバーには、メモの要約のためのプロンプト生成機能が含まれています。

  • 簡潔な要約と詳細な要約の両方をサポート

  • 言語モデル入力のフォーマットノート

  • 「summarize-notes」プロンプトから利用可能

発達

サーバーを変更または拡張するには:

  1. リポジトリをクローンする

  2. 開発依存関係をインストールする

  3. 適切なモジュールに変更を加える

  4. 展開前に徹底的にテストする

テスト

テストでは以下をカバーします:

  • 基本的なCRUD操作

  • 複数のノートの取り扱い

  • エラーケース

  • リソースアクセス

  • プロンプト生成

ライセンス

[ここにライセンスを追加]

Available Tools

4 tools
add-noteC

Create a new note

Inputs: content (required), name (required).

delete-noteC

Delete an existing note

Inputs: name (required).

list-all-notesB

Read all stored notes

Inputs: no named parameters.

update-noteC

Update an existing note

Inputs: content (required), name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific CRUD operations on notes: add-note for creation, delete-note for deletion, list-all-notes for reading all, and update-note for updates. There is no overlap in functionality, making tool selection unambiguous.

    Naming Consistency4/5

    The tools follow a mostly consistent verb-noun pattern (add-note, delete-note, update-note), but list-all-notes deviates slightly by including 'all'. This minor inconsistency does not significantly hinder readability or predictability.

    Tool Count5/5

    With 4 tools, the server is well-scoped for a notes management system, covering the essential CRUD operations. Each tool earns its place without being overly sparse or bloated, fitting the typical 3-15 tool range appropriately.

    Completeness5/5

    The tool set provides complete CRUD coverage for the notes domain: create (add-note), read (list-all-notes), update (update-note), and delete (delete-note). There are no obvious gaps, allowing agents to handle full note lifecycles without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers