MCP Notes

🚀 📚 MCP 筆記

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. 📚 知識分類

系統中的所有筆記都歸屬於以下四個類別之一：

• 🏆 成就：解決問題、完成功能、修復錯誤。
• 💡 視察：模式、架構決策、更好工作方式。
• 📝 待辦事項：與更大目標相關的任務，有意義的改進。
• 📖 知識：技術細節、背景信息、理由、技巧。

🎨 設計原則

1. 📄 純文本優先

所有筆記以 Markdown 文件形式存儲，確保跨工具兼容性和長期保存。

2. 🗂️ 自動組織

利用 MCP 的上下文理解，自動將筆記歸檔到合適的主題和關係中。

3. 💡 可擴展性

支持無限層級的知識鏈接和交叉引用，構建深厚的知識網絡。

📋 實現特點

• 模塊化：松耦合組件便於替換或升級。
• 可插拔：提供多種存儲後端和 UI 前端選項。
• 可擴展：開放 API 支持自定義功能。
• 高效：採用優化的搜索和檢索算法。

💡 可用提示

是原子嗎？

將大想法分解為最簡單的獨立部分。使用此提示可將大型想法拆分為更小的概念，較小的筆記能更方便地與其他筆記鏈接。