MCP Notes

📚 MCP 注释

基于模型上下文协议 (MCP) 构建的个人知识管理系统，将日常笔记转化为有组织的、可搜索的知识。

🚀 使用方法

🛠️ 手动设置

1. 克隆存储库
   git clone git@github.com:markacianfrani/mcp-notes.git cd mcp-notes npm i npm run build
2. 设置 MCP

🖥️ 克劳德桌面

添加到您的 claude-desktop-config.json：

🌟 项目愿景

MCP Notes 旨在通过创建一个系统来解决知识碎片化的问题，在这个系统中，日常的想法、成就和见解可以：

1. 📥 以最小的摩擦快速捕获
2. 🗂️ 自动组织成有意义的结构
3. 🧠 综合成更高层次的知识
4. 🔍 需要时可轻松检索

目标是构建一个外部橡皮鸭，它可以从任何工具中实时转储你的工作记忆并对垃圾进行分类。

🧩 核心概念

1.📅 每日日志

每日日志是 MCP Notes 中记录内容的最基本单位。每天都会生成一个独立的 Markdown 文件，用于记录一天的观察结果。您可以将每日日志想象成一本运行中的账本。

💡 提示：使用 Claude Desktop 的快速输入键盘快捷键

MCP 与工具无关，因此您可以在对话和工具之间使用 /log - 要求 Copilot 或 Cursor 在修复错误后记录经验教训摘要，或让 Claude Desktop 保存解决旧问题的新方法。

2. 📊 Rollups

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

3. 📚 知识类别

系统中的所有注释都属于以下四类之一：

• 🏆 成就：解决问题、完成功能、修复错误
• 💡 洞察：模式、架构决策、更好的工作方式
• 📝 TODO ：与更大目标相关的任务，有意义的改进
• 📖 知识：技术细节、背景、原理、技术

🎨设计原则

MCP Notes 基于以下几个核心设计原则：

1. 📄 纯文本优先

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

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

2. ✍️ 低摩擦捕获

主要界面的设计旨在最大限度地减少记录想法的摩擦：

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

3.🔄进步组织

MCP Notes 并不要求预先进行严格的组织，而是采用渐进的方式：

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

4. 🤖 人工智能增强

该系统利用人工智能来增强人类思维，而不是取代人类思维：

• 帮助分类信息
• 生成摘要和连接
• 表面相关的过去笔记
• 识别跨时间的模式

🧰 可用工具

MCP Notes 提供了一组可通过 Claude Desktop 或其他 MCP 兼容客户端调用的工具。这些工具可帮助您捕获、整理和检索笔记。

📝 核心笔记工具

/log

使用您的笔记创建或更新今天的每日日志文件。

调用：“将此记录到我的日志中：...”，“将其摘要添加到我的日志中：...”。

/rollup

将每日笔记综合成具有类别、联系和行动项目的有组织的摘要。

调用：“汇总我今天的笔记”

write_note

创建新注释或用内容覆盖现有注释。

sticky

根据可操作性、持久性、可发现性和未来参考价值来评估想法的“粘性”。

询问：“这个想法有吸引力吗？”

evaluateInsight

评估见解或想法的长期价值和意义。

询问：“这个见解有长期价值吗？”

📂 文件系统工具

search_files

递归搜索您的笔记目录中与模式匹配的文件和目录。

read_note

从您的笔记目录中读取笔记文件的完整内容。

read_multiple_notes

同时读取多个笔记文件的内容。

list_directory

列出笔记中目录的内容。

create_directory

在您的笔记中创建一个新目录。

查看CHANGELOG.md文件了解版本历史和更改。

💡 可用提示

这是原子的吗？

将想法分解成最简单的独立部分。使用此提示可以将大想法转化为更小的概念。小笔记可以更轻松地与其他笔记关联。