📚 MCP Notes

📚 MCP Notes

Model Context Protocol（MCP）を基盤として構築された個人向けナレッジ管理システムです。日々のメモを整理され、検索可能なナレッジに変換します。

🚀 使用方法

🛠️ 手動セットアップ

1. リポジトリをクローンする

   git clone [email protected]:markacianfrani/mcp-notes.git
   cd mcp-notes
   npm i
   npm run build
   

2. MCP をセットアップする

🖥️ Claude Desktop

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

"notes": {
    "command": "node",
    "args": [
        "path/to/this/repo/mcp-notes/dist/index.js",
        "path/to/your/notes"
    ],
},

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

MCP Notes は、日々の考え、成果、気づきを次のようにできるシステムを構築することで、ナレッジの断片化という問題を解決することを目指しています：

1. 📥 手間を最小限に抑えてすばやく記録する
2. 🗂️ 意味のある構造に自動で整理する
3. 🧠 より高次のナレッジへと統合する
4. 🔍 必要なときに簡単に検索する

目標は、どのツールからでも作業記憶をリアルタイムで書き出し、情報の山を整理してくれる外部のラバーダックを構築することです。

🧩 基本概念

1. 📅 日次ログ

日次ログは、MCP Notes における記録の基本単位です。毎日専用の Markdown ファイルが作成され、その日に気づいたことを記録できます。日次ログは、日々書き足していく台帳のようなものです。

💡 TIP: 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 ファイルをご覧ください。

💡 利用可能なプロンプト

これはアトミックですか？

アイデアを、単独で成り立つ最小単位に分解します。このプロンプトを使うと、大きなアイデアを小さな概念に分けられます。小さなノートは、ほかのノートとより簡単にリンクできます。