local-only server

The server can only run on the client’s local machine because it depends on local resources.

MCP ノートサーバー

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

特徴

メモの作成、閲覧、更新、削除
JSONを使用した永続ストレージ
作成と変更のタイムスタンプ追跡
プロンプトによるメモの要約
note:// URIスキームを使用したリソースベースのアクセス

インストール

Smithery経由でインストール

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

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

手動インストール

Python 3.10以降がインストールされていることを確認してください
仮想環境を作成します。
python -m venv .venv # On Unix/MacOS: source .venv/bin/activate # On Windows: .venv\Scripts\activate
インストール要件:
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 : メモを削除する

使用法

サーバーを起動します。
mcp install src/notes mcp start Notes
操作例:
# 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」プロンプトから利用可能

発達

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

リポジトリをクローンする
開発依存関係をインストールする
適切なモジュールに変更を加える
展開前に徹底的にテストする

テスト

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

基本的なCRUD操作
複数のノートの取り扱い
エラーケース
リソースアクセス
プロンプト生成

ライセンス

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

メモを管理および永続化し、CRUD 操作、メモの要約、note:// URI スキームを介したリソースベースのアクセスを提供する MCP サーバー。

Related Resources

Reddit Discussion about this server

MCP Notes Server