MCP Notes Server

MCP Notes Server

永続ストレージを使用してノートを管理する、Model Context Protocol（MCP）サーバーの実装です。

機能

• ノートの作成、読み取り、更新、削除
• JSON を使用した永続ストレージ
• 作成日時と更新日時の記録
• プロンプトによるノートの要約
• note:// URI スキームを使用したリソースベースのアクセス

インストール

Smithery 経由でのインストール

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

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 を使用して特定のノートにアクセスします

プロンプトの生成

このサーバーには、ノートを要約するためのプロンプト生成機能が含まれています：

• 簡潔な要約と詳細な要約の両方に対応しています
• LLM 入力用にノートをフォーマットします
• 「summarize-notes」プロンプトから利用できます

開発

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

1. リポジトリをクローンします
2. 開発用の依存関係をインストールします
3. 適切なモジュールを変更します
4. デプロイ前に十分にテストします

テスト

テストでは、次の項目を対象にします：

• 基本的な CRUD 操作
• 複数のノートの処理
• エラーケース
• リソースへのアクセス
• プロンプトの生成

ライセンス

[ライセンスをここに追加してください]