📚 MCP 笔记

一个基于 Model Context Protocol (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 是工具中立的，因此您可以在任何对话或工具中 /log，例如让 Copilot 或 Cursor 在修复一个错误后记录对新方法的学习。

2. 📊 摘要

摘要会自动生成，将每日日志浓缩为更高层次的见解和模式。它们帮助将孤立的信息连接成有意义的工作和思考的连贯叙述。

3. 📚 知识分类

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

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

🎨 设计原则

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

1. 📄 纯文本优先

所有笔记都以 Markdown 文件形式存储，确保跨工具兼容性和长期保存。

2. 🗂️ 自动组织

利用 MCP 的上下文理解，自动将笔记归档到合适主题和关系中。

3. 💡 可扩展性

支持无限层级的知识链接和交叉引用，构建深厚知识网络。

📋 实现特点

• 模块化：松耦合组件便于替换或升级
• 可插拔：多种存储后端和 UI 前端选项
• 可扩展：开放 API 支持自定义功能
• 高效：优化的搜索和检索算法

💡 可用提示

是原子吗？

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

以上是 MCP 笔记项目的完整中文翻译，仅包含原文内容，无任何额外信息。