📚 MCP Notes

📚 MCP Notes

基于 Model Context Protocol（MCP）构建的个人知识管理系统，可将每日笔记转化为有序、可搜索的知识。

🚀 使用方法

🛠️ 手动设置

1. 克隆仓库

   git clone [email protected]:markacianfrani/mcp-notes.git
   cd mcp-notes
   npm i
   npm run build
   

2. 设置 MCP

🖥️ Claude Desktop

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

"notes": {
    "command": "node",
    "args": [
        "path/to/this/repo/mcp-notes/dist/index.js",
        "path/to/your/notes"
    ],
},

🌟 项目愿景

MCP Notes 旨在解决知识碎片化问题，创建一个系统，让日常想法、成就和见解能够：

1. 📥 轻松快速地记录
2. 🗂️ 自动整理成有意义的结构
3. 🧠 提炼成更高层次的知识
4. 🔍 在需要时轻松检索

目标是打造一个外部“橡皮鸭”，能够通过任何工具实时倾倒你的工作记忆，并从中筛出有用内容。

🧩 核心概念

1. 📅 每日日志

每日日志是 MCP Notes 中记录信息的最小单位。每天都会有一个专属的 Markdown 文件，供你记录全天的观察。可以把每日日志看作一份持续更新的账簿。

💡 TIP：善用 Claude Desktop 的快速记录键盘快捷键

MCP 不依赖特定工具，因此你可以在不同对话和工具中使用 /log——例如，让 Copilot 或 Cursor 在修复 Bug 后记录经验总结，或让 Claude Desktop 保存解决旧问题的新方法。

2. 📊 汇总

汇总会自动生成，将每日日志浓缩为更高层次的见解和模式，帮助你将孤立的信息串联起来，形成关于工作和思考的连贯叙述。

3. 📚 知识类别

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

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

🎨 设计原则

MCP Notes 基于以下几项核心设计原则构建：

1. 📄 纯文本优先

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

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

2. ✍️ 轻松记录

主要界面的设计旨在尽可能降低记录想法的阻力：

• 简单的文本输入
• 自动分类辅助
• 记录时无需进行复杂整理

3. 🔄 渐进式整理

MCP Notes 不要求一开始就进行严格整理，而是采用渐进式方法：

• 记录原始想法和活动
• 自动对内容分类
• 生成定期摘要
• 随时间推移关联相关条目

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 文件。

💡 可用提示词

这是否是原子化的？

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