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 支持自定义功能。
• 高效：采用优化的搜索和检索算法。

💡 可用提示

是原子吗？

将大想法分解为最简单的独立部分。使用此提示可将大型想法拆分为更小的概念，较小的笔记能更方便地与其他笔记链接。