Note Manager MCP Server for Claude Desktop

Claude Desktop 向け Note Manager MCP サーバー

MCP クライアントとの連携に対応したエージェントと統合する、ノート管理アプリケーション向けの MCP サーバーです。Claude Desktop でテスト済みで、Claude との会話中にノートを管理できます。

機能

• ユーザーのすべてのノートを表示
• 日時のタイムスタンプを自動付与して新しいノートを追加
• ID でノートを削除
• キーワードでノートを検索
• 日付でノートを検索

インストール

前提条件

• Python 3.10 以上
• Claude Desktop アプリケーション

セットアップ手順

1. uv をインストール（Python パッケージマネージャー）

   pip install uv
   
   # On Windows
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

2. プロジェクトディレクトリを作成

   uv init note-manager-mcp-server
   cd note-manager-mcp-server
   

3. MCP CLI を追加

   uv add "mcp[cli]"
   

4. main.py を作成

   プロジェクトディレクトリに、ノート管理サーバーのコードを含む main.py ファイルを作成します。（含める内容については、実装の詳細セクションを参照してください）

5. Claude Desktop にサーバーをインストール

   uv run mcp install main.py
   

6. Claude Desktop を再起動

   • タスクマネージャーから、実行中の Claude のインスタンスを終了します
   • Claude Desktop を再起動します
   • Claude でノート管理ツールを利用できるようになります

実装の詳細

サーバーは Claude に次のツールを提供します。

• get_notes(user_id): ユーザーのすべてのノートを取得
• add_note(user_id, note): 現在の日付で新しいノートを追加
• delete_note_by_id(user_id, note_id): ID を指定して特定のノートを削除
• search_notes(user_id, keyword): キーワードでノートを検索
• search_notes_by_date(user_id, date): 作成日でノートを検索

データはセッション中、メモリに保存されます。

使い方

インストール後、Claude Desktop で次のように尋ねることで、ノートマネージャーを利用できます。

• 「ノートを見せて」
• 「[topic] についての新しいノートを追加して」
• 「ID が [note_id] のノートを削除して」
• 「[keyword] についてのノートを探して」
• 「[date] のノートを見せて」

Claude は適切なツールを使用してノートを管理します。

MCP Inspector を起動

uv run mcp dev main.py

注意

これはメモリ内ストレージを使用するシンプルな実装です。サーバーを再起動すると、ノートは保持されません。