MCP Notes

🚀 📚 MCP ノート

Model Context Protocol (MCP) をベースにした個人用の知識管理システムで、日常のノートを整理された、検索可能な知識に変換します。

🚀 クイックスタート

🛠️ 手動設定

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

   git clone git@github.com:markacianfrani/mcp-notes.git
   cd mcp-notes
   npm i
   npm run build
   

2. MCP を設定する

🖥️ Claude デスクトップ版

claude - desktop - config.json に以下を追加します。

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

✨ 主な機能

MCP ノートは、知識の断片化問題を解決することで、日常の考え、成果、洞察を以下のように取り扱えるシステムを構築することを目指しています。

1. 📥 最小限の手間で迅速にキャプチャする
2. 🗂️ 自動的に意味のある構造に整理する
3. 🧠 より高いレベルの知識に昇華する
4. 🔍 必要なときに簡単に検索する

目標は、あらゆるツールからリアルタイムで作業メモリを記録し、整理するための外部思考外化ツールを作ることです。

🔧 技術詳細

1. 📅 毎日のログ

毎日のログは、MCP ノートの基本的なキャプチャ単位です。毎日が独自の Markdown ファイルを持ち、全日の観察を記録します。毎日のログは、稼働中の元帳と考えることができます。

💡 ヒント：Claude デスクトップ版のクイック入力キーボードショートカットを利用しましょう

MCP はツール中立的であるため、任意の会話やツールで /log を使用できます。たとえば、エラーを修正した後に、Copilot や Cursor に新しい方法の学習を記録させることができます。

2. 📊 要約

要約は自動生成され、毎日のログをより高いレベルの洞察とパターンに凝縮します。孤立した情報をつなぎ、作業と思考の意味のある一貫した物語にするのに役立ちます。

3. 📚 知識分類

システム内のすべてのノートは、以下の 4 つのカテゴリのいずれかに属します。

• 🏆 成果：問題の解決、機能の完成、エラーの修正
• 💡 洞察：パターン、アーキテクチャの決定、より良い作業方法
• 📝 タスク：より大きな目標に関連するタスク、有意義な改善
• 📖 知識：技術的な詳細、背景情報、理由、テクニック

🎨 設計原則

MCP ノートは、いくつかの核心的な設計原則に基づいています。

1. 📄 純粋なテキストを優先

すべてのノートは Markdown ファイルとして保存され、ツール間の互換性と長期保存を保証します。

2. 🗂️ 自動整理

MCP のコンテキスト理解を利用して、ノートを適切なトピックと関係に自動的にアーカイブします。

3. 💡 拡張性

無限の階層の知識リンクと相互参照をサポートし、深い知識ネットワークを構築します。

📦 実装の特徴

• モジュール化：緩く結合されたコンポーネントは、交換またはアップグレードが容易です。
• プラグアンドプレイ：複数のストレージバックエンドと UI フロントエンドのオプションがあります。
• 拡張可能：オープン API でカスタム機能をサポートします。
• 効率的：最適化された検索と検索アルゴリズムを備えています。

💡 利用可能なヒント

原子的ですか？

大きなアイデアを最も単純な独立した部分に分解します。このヒントを使って、大きなアイデアを小さな概念に分割します。小さなノートは、他のノートとのリンクが容易になります。