使用说明
📚 MCP注释
基于模型上下文协议（MCP）构建的个人知识管理系统，将日常笔记转化为有组织、可搜索的知识。
🚀 用法
🛠️ 手动设置
-
克隆存储库
git clone git@github.com:markacianfrani/mcp-notes.git cd mcp-notes npm i npm run build -
设置MCP
🖥️ 克劳德桌面
添加到claude-desktop-config.json：
"notes": {
"command": "node",
"args": [
"path/to/this/repo/mcp-notes/dist/index.js",
"path/to/your/notes"
],
},
🌟 项目愿景
MCP Notes旨在通过创建一个系统来解决知识碎片化的问题，在这个系统中，日常思维、成就和见解可以：
- 📥 以最小的摩擦快速捕获
- 🗂️ 自动组织成有意义的结构
- 🧠 综合成更高层次的知识
- 🔍 需要时可轻松检索
目标是构建一个外部橡皮鸭，它可以从任何工具实时转储你的工作内存，并对垃圾进行分类。
🧩 核心概念
1.📅 每日日志
日志是MCP Notes中捕获的原子单位。每天都有自己的标记文件，您可以在其中记录全天的观察结果。把每日日志想象成一个正在运行的分类账。
💡 提示：使用Claude Desktop的快速输入键盘快捷键
MCP与工具无关，因此您可以/记录对话，也可以记录工具——让Copilot或Cursor记录修复错误后吸取的经验教训摘要，或者让Claude Desktop保存一种新的方法来解决旧问题。
2.📊 汇总
汇总是自动生成的摘要，将每日日志浓缩为更高层次的见解和模式。它们有助于将孤立的信息片段连接成一个连贯的工作和思维叙述。
3.📚 知识类别
系统中的所有注释分为四类：
- 🏆 成就：解决问题、完成功能、修复错误
- 💡 洞察：模式、架构决策、更好的工作方式
- 📝 全部：与更大目标相关的任务，有意义的改进
- 📖 知识：技术细节、背景、原理、技术
🎨 设计原则
MCP Notes建立在几个核心设计原则之上：
1.📄 纯文本优先
所有笔记都以纯文本Markdown文件存储，确保：
- 面向未来的存储，不会被锁定在专有格式中
- 版本控制兼容性
- 使用任何文本编辑器轻松编辑
- 透明的数据结构
2.✍️ 低摩擦捕捉
主要界面旨在最大限度地减少记录想法的摩擦：
- 简单的文本输入
- 自动分类辅助
- 捕获时不需要复杂的组织
3.🔄 进步组织
MCP Notes采用了一种渐进的方法，而不是预先要求严格的组织：
- 捕捉原始想法和活动
- 自动对内容进行分类
- 生成定期摘要
- 随着时间的推移连接相关项目
4。🤖 AI增加
该系统利用人工智能来增强人类思维，而不是取代它：
- 帮助对信息进行分类
- 生成摘要和连接
- 表面相关的过去笔记
- 识别跨时间的模式
🧰 可用工具
MCP Notes提供了一组可以通过Claude Desktop或其他MCP兼容客户端调用的工具。这些工具允许您捕获、组织和检索笔记。
📝 核心笔记工具
/log
使用您的笔记创建或更新今天的每日日志文件。
调用：“将此记录到我的每日日志：…”，“将其摘要添加到我的日志：…。”
/rollup
将每日笔记合成一个有组织的摘要，包括类别、联系和行动项。
调用：“汇总我今天的笔记”
write_note
创建新笔记或用内容覆盖现有笔记。
sticky
根据可操作性、持久性、可发现性和未来参考值来评估一个想法的“粘性”。
调用：“这个想法有粘性吗？”
evaluateInsight
评估一个见解或想法的长期价值和意义。
调用：“从长远来看，这种见解有价值吗？”
📂 文件系统工具
search_files
递归搜索与notes目录中的模式匹配的文件和目录。
read_note
从笔记目录中读取笔记文件的完整内容。
read_multiple_notes
同时读取多个笔记文件的内容。
list_directory
列出笔记中目录的内容。
create_directory
在笔记中创建新目录。
请参阅 更改日志.md 版本历史和更改文件。
💡 可用提示
这是原子的吗？
将想法分解为最简单的独立部分。使用此提示将大想法转化为小概念。较小的音符可以更容易地链接到其他音符。