📚 MCPノート

モデル コンテキスト プロトコル (MCP) に基づいて構築された個人用知識管理システムで、日常のメモを整理され検索可能な知識に変換します。

🚀 使用方法

🛠️ 手動設定

1. リポジトリをクローンする
   git clone git@github.com:markacianfrani/mcp-notes.git cd mcp-notes npm i npm run build
2. MCPのセットアップ

🖥️ クロード・デスクトップ

claude-desktop-config.json に追加します:

🌟 プロジェクトのビジョン

MCP Notes は、日々の考え、成果、洞察を次の方法で記録できるシステムを作成することで、知識の断片化の問題を解決することを目指しています。

1. 📥 最小限の摩擦で素早くキャプチャ
2. 🗂️ 意味のある構造に自動的に整理されます
3. 🧠 より高度な知識に統合
4. 🔍 必要なときに簡単に取得できます

目標は、あらゆるツールからリアルタイムで作業記憶をダンプし、不要なデータを選別できる外部のゴム製のアヒルを構築することです。

🧩 コアコンセプト

1. 📅 日次ログ

日次ログは、MCP Notesにおける記録の最小単位です。各日には専用のマークダウンファイルが用意され、そこに一日を通して観察したことを記録できます。日次ログは、稼働中の台帳のようなものだと考えてください。

💡ヒント: Claude Desktopのクイック入力キーボードショートカットを活用しましょう

MCP はツールに依存しないため、会話だけでなくツール全体で /log を実行できます。たとえば、Copilot または Cursor にバグ修正後の教訓の概要をログに記録するよう依頼したり、Claude Desktop に古い問題に対する新しいアプローチを保存させたりできます。

2. 📊 ロールアップ

ロールアップは、日々のログを高次の洞察とパターンに凝縮する自動生成されるサマリーです。ばらばらの情報をつなぎ合わせ、仕事や思考を一貫した物語にまとめるのに役立ちます。

3. 📚 知識カテゴリー

システム内のすべてのメモは、次の 4 つのカテゴリのいずれかに分類されます。

• 🏆 達成: 問題の解決、機能の完成、バグの修正
• 💡 洞察：パターン、アーキテクチャ上の決定、より良い働き方
• 📝 TODO : より大きな目標、意味のある改善につながるタスク
• 📖 知識: 技術的な詳細、背景、根拠、テクニック

🎨 デザインの原則

MCP Notes は、いくつかのコア設計原則に基づいて構築されています。

1. 📄 プレーンテキストを優先

すべてのメモはプレーンテキストの Markdown ファイルとして保存され、次のことが保証されます。

• 独自のフォーマットに縛られない、将来を見据えたストレージ
• バージョン管理の互換性
• 任意のテキストエディタで簡単に編集できます
• 透明なデータ構造

2. ✍️ 低摩擦キャプチャ

主なインターフェースは、考えを記録する際の摩擦を最小限に抑えるように設計されています。

• シンプルなテキスト入力
• 自動分類支援
• キャプチャ時に複雑な構成は不要

3. 🔄進歩的な組織

MCP Notes では、事前に厳格な組織化を要求するのではなく、漸進的なアプローチを採用しています。

• 生の思考や活動を記録
• コンテンツを自動的に分類する
• 定期的な要約を生成する
• 関連するアイテムを時間の経過とともに接続する

4. 🤖 AI拡張

このシステムは、AI を活用して人間の思考を置き換えるのではなく、強化します。

• 情報の分類に役立つ
• 要約と接続を生成する
• 関連する過去のメモを表面化する
• 時間経過に伴うパターンを特定する

🧰 利用可能なツール

MCP Notesは、Claude Desktopやその他のMCP対応クライアントから呼び出せるツールセットを提供します。これらのツールを使用すると、メモをキャプチャ、整理、取得できます。

📝 コアノートツール

/log

今日の毎日のログ ファイルをメモとともに作成または更新します。

「これを毎日のログに記録する: ...」、「その要約をログに追加する: ...」で呼び出します。

/rollup

毎日のメモを、カテゴリ、接続、アクション項目を含む整理された要約に統合します。

「今日のメモをまとめる」で呼び出します

write_note

新しいメモを作成するか、既存のメモをコンテンツで上書きします。

sticky

実行可能性、寿命、検索可能性、将来の参照価値に基づいて、思考の「粘着性」を評価します。

「このアイデアは定着しますか？」と尋ねます。

evaluateInsight

洞察や考えの長期的な価値と重要性を評価します。

「この洞察は長期的に見て価値があるか？」という問いかけをします。

📂 ファイルシステムツール

search_files

ノートディレクトリ内のパターンに一致するファイルとディレクトリを再帰的に検索します。

read_note

ノートディレクトリからノートファイルの完全な内容を読み取ります。

read_multiple_notes

複数のノートファイルの内容を同時に読み取ります。

list_directory

ディレクトリの内容をメモに一覧表示します。

create_directory

メモに新しいディレクトリを作成します。

バージョン履歴と変更については、 CHANGELOG.mdファイルを参照してください。

💡 利用可能なプロンプト

これは原子ですか？

アイデアを最も単純な独立した要素に分解します。このプロンプトを使って、大きなアイデアを小さな概念に分解します。小さなメモは他のメモと簡単にリンクできます。