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操作

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

• エラーケース

• リソースアクセス

• プロンプト生成

ライセンス

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