log-reflect-mcp

log-reflect-mcp — это локальный MCP-сервер для персональной системы записи. Он предоставляет ИИ-клиенту небольшой явный интерфейс для захвата и получения записей в формате Markdown, сохраняя сами записи в отдельном репозитории.

Он разработан для работы с соглашениями о каталогах, используемыми в log-reflect-practice:

daily/
├── journal/{YYYY}/{YYYYMM}/
└── inputs/{YYYY}/{YYYYMM}/
practices/

Текущий объём

Первая версия намеренно предоставляет только четыре инструмента:

• capture_journal: создать или дополнить фрагмент личного журнала.

• capture_input: сохранить внешний ввод как заметку в Markdown.

• get_records_by_date_range: получить записи журнала и ввода для просмотра.

• search_records: искать по содержимому записей.

MCP-сервер обрабатывает доступ и хранение. Навыки агента (Agent Skills) остаются ответственными за суждения: насколько легко редактировать журнал, что относится к заметке ввода, как просматривать семь дней и когда повторяющаяся тема готова стать Практикой (Practice).

Related MCP server: ai-journal

Границы безопасности

• Исходный репозиторий не содержит личных записей или учётных данных.

• Сервер может читать только daily/journal/ и daily/inputs/.

• Новые записи записываются только внутри этих двух каталогов.

• Существующие файлы ввода никогда не перезаписываются молча.

• Если для даты существует более одного файла журнала, запись останавливается вместо предположения.

Установка

Требования: Node.js 22 или новее.

npm install
cp .env.example .env

Укажите абсолютный путь к вашему репозиторию записей:

RECORDS_REPO_PATH=/absolute/path/to/log-reflect-practice

Соберите и запустите stdio-сервер:

npm run build
RECORDS_REPO_PATH=/absolute/path/to/log-reflect-practice npm start

Пример конфигурации клиента

После сборки укажите MCP-клиенту на скомпилированный сервер:

{
  "mcpServers": {
    "log-reflect": {
      "command": "node",
      "args": ["/absolute/path/to/log-reflect-mcp/dist/src/server.js"],
      "env": {
        "RECORDS_REPO_PATH": "/absolute/path/to/log-reflect-practice",
        "RECORDS_TIME_ZONE": "America/Los_Angeles"
      }
    }
  }
}

Разработка

npm run check
npm test

Чтобы интерактивно просмотреть инструменты:

npx @modelcontextprotocol/inspector node dist/src/server.js

Дорожная карта

• Добавить ресурсы MCP для чтения отдельных записей.

• Добавить подсказки для обзора и разработки практик, не перенося суждения в код хранения.

• Добавить опциональный рабочий процесс коммитов Git.

• Добавить адаптер хранения на основе GitHub.

• Добавить Streamable HTTP и OAuth только после того, как локальный рабочий процесс станет стабильным.