📚 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 是工具无关的，因此你可以跨对话甚至工具进行日志记录——请求 Copilot 或 Cursor 在修复错误后总结经验教训，或者让 Claude 桌面保存对旧问题的新解决方案。

2. 📊 汇总

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

3. 📚 知识分类

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

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

🎨 设计原则

MCP 笔记基于几个核心设计原则构建：

1. 📄 纯文本优先

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

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

2. ✍️ 低摩擦捕获

主要界面设计用于最小化记录想法的摩擦：

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

3. 🔄 进步式组织

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

• 捕获原始想法和活动
• 自动分类内容
• 定期生成摘要
• 随时间连接相关项

4. 🤖 AI 增强

系统利用 AI 来增强人类思维，而不是取代它：

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

🧰 可用工具

MCP 笔记提供了一组可以通过 Claude 桌面或其他兼容 MCP 的客户端调用的工具。这些工具允许你捕获、组织和检索笔记。

📝 核心笔记工具

/log

创建或更新今天的日志文件，添加你的笔记。

调用方式："将这个添加到我的日志中：..."，"将那个总结添加到我的日志中：...."

/rollup

将每日笔记合成一个有组织的摘要，包括类别、连接和行动项。

调用方式："今天总结我的笔记"

write_note

创建一个新的笔记或覆盖现有笔记的内容。

sticky

评估一个想法的“粘性”，基于其可操作性、持久性、可查找性和未来的参考价值。

调用方式："这个想法有粘性吗？"

evaluateInsight

评估一个见解或想法的长期价值和重要性。

调用方式："这个见解对未来有价值吗？"

📂 文件系统工具

search_files

递归搜索匹配模式的文件和目录。

read_note

读取笔记目录中的完整笔记内容。

read_multiple_notes

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

list_directory

列出笔记目录中的内容。

create_directory

在笔记中创建新目录。

查看 CHANGELOG.md 文件以获取版本历史和更改。

💡 可用提示

这是原子的吗？

将想法分解为其最简单的独立部分。使用此提示将大想法转化为更小的概念。较小的笔记可以更容易地与其他笔记关联。 </中文翻译>