mcp-notes-главный

📚 Заметки МКП

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

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

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

Клонировать репозиторий

git clone git@github.com:markacianfrani/mcp-notes.git
cd mcp-notes
npm i
npm run build

Настройка МКП

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

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

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

Related MCP server: Rememberizer MCP Server

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

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

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

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

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

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 .

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

Это атомно?

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

MCP Notes