local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Uses Git for version control of notes, allowing cloning of the repository and tracking changes to the knowledge base over time
Stores all notes as plain text Markdown files, ensuring future-proof storage, easy editing, and transparent data structures
Utilizes npm for package management and installation of the server's dependencies
📚 MCP 注释
基于模型上下文协议 (MCP) 构建的个人知识管理系统，将日常笔记转化为有组织的、可搜索的知识。
🚀 使用方法
🛠️ 手动设置
- 克隆存储库Copy
- 设置 MCP
🖥️ 克劳德桌面
添加到您的 claude-desktop-config.json：
🌟 项目愿景
MCP Notes 旨在通过创建一个系统来解决知识碎片化的问题，在这个系统中，日常的想法、成就和见解可以：
- 📥 以最小的摩擦快速捕获
- 🗂️ 自动组织成有意义的结构
- 🧠 综合成更高层次的知识
- 🔍 需要时可轻松检索
目标是构建一个外部橡皮鸭，它可以从任何工具中实时转储你的工作记忆并对垃圾进行分类。
🧩 核心概念
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文件了解版本历史和更改。
💡 可用提示
这是原子的吗？
将想法分解成最简单的独立部分。使用此提示可以将大想法转化为更小的概念。小笔记可以更轻松地与其他笔记关联。
You must be authenticated.
个人知识管理系统，使用模型上下文协议将日常笔记转换为有组织的、可搜索的知识。