📚 MCP 笔记

一个基于模型上下文协议（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 记录修复 bug 后的经验教训摘要，或者让 Claude 桌面版保存解决旧问题的新方法。

2. 📊 汇总

汇总是一种自动生成的摘要，它将日志浓缩为更高层次的见解和模式。它们有助于将孤立的信息片段连接成一个关于你的工作和思考的连贯叙述。

3. 📚 知识类别

系统中的所有笔记都属于以下四个类别之一：

• 🏆 成就：解决问题、完成功能、修复 bug
• 💡 见解：模式、架构决策、更好的工作方式
• 📝 待办事项：与更大目标相关的任务、有意义的改进
• 📖 知识：技术细节、背景、理由、技巧

🎨 设计原则

MCP 笔记建立在几个核心设计原则上：

1. 📄 优先考虑纯文本

所有笔记都以纯文本 Markdown 文件形式存储，确保了：

• 不会被锁定在专有格式中，具有面向未来的存储
• 兼容版本控制
• 可以用任何文本编辑器轻松编辑
• 数据结构透明

2. ✍️ 低摩擦捕捉

主要界面设计用于减少记录想法时的摩擦：

• 简单的文本输入
• 自动分类辅助
• 捕捉时不需复杂的组织

3. 🔄 逐步组织

MCP 笔记采用了一种渐进式的方法，而不是一开始就要求严格的组织：

• 捕捉原始想法和活动
• 自动对内容进行分类
• 定期生成摘要
• 随时间推移连接相关条目

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 文件以获取版本历史和变更记录。

💡 可用提示

这是原子性的吗？

将想法分解为其最简单的独立部分。使用此提示将大想法转化为更小的概念。较小的笔记可以更容易地与其他笔记链接。