MCP Notes

📚 Заметки МКП

Система управления персональными знаниями, построенная на протоколе контекста модели (MCP), которая преобразует ежедневные заметки в организованные, доступные для поиска знания.

🚀 Использование

🛠️ Ручная настройка

1. Клонировать репозиторий
   git clone git@github.com:markacianfrani/mcp-notes.git cd mcp-notes npm i npm run build
2. Настройка МКП

🖥️ Клод Рабочий стол

Добавьте в ваш claude-desktop-config.json:

🌟 Видение проекта

MCP Notes направлен на решение проблемы фрагментации знаний путем создания системы, в которой ежедневные мысли, достижения и идеи могут быть:

1. 📥 Быстрое фотографирование с минимальным трением
2. 🗂️ Автоматически организованы в осмысленные структуры
3. 🧠 Синтезировано в знания более высокого уровня
4. 🔍 Легко извлекается при необходимости

Цель состоит в том, чтобы создать внешнюю резиновую утку, которая сможет в режиме реального времени выгружать вашу рабочую память из любого инструмента и сортировать мусор.

🧩 Основные концепции

1. 📅 Ежедневные журналы

Ежедневные журналы — это атомарная единица записи в MCP Notes. Каждый день получает свой собственный файл разметки, в котором вы можете записывать наблюдения в течение дня. Думайте о ежедневных журналах как о текущей бухгалтерской книге.

💡 СОВЕТ: используйте сочетание клавиш быстрого доступа Claude Desktop

MCP не зависит от инструментов, поэтому вы можете вести журнал не только разговоров, но и инструментов — попросите 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 .

💡 Доступные подсказки

Это атомно?

Разбивает идеи на простейшие отдельные части. Используйте эту подсказку, чтобы превратить большие идеи в более мелкие концепции. Более мелкие заметки можно гораздо проще связать с другими заметками.