dev-diary-mcp

Сервер Model Context Protocol, который превращает папку с Markdown-файлами в поисковый рабочий журнал, доступный для чтения и записи любой LLM.

Никакой базы данных. Никакого приложения. Ваш рабочий журнал — это просто diary/2026-08-22.md — читаемый человеком, удобный для диффов и git — а ваш ИИ-ассистент получает четыре инструмента для работы с ним:

Зачем

«Записать, что я делал сегодня» — это задача, которую все бросают через неделю. Но ваш ИИ-ассистент уже знает, что вы делали, — он помогал вам это делать. Дайте ему инструменты для работы с Markdown-папкой — и ведение рабочего журнала станет побочным эффектом работы с ИИ.

Запуск демо

В репозитории есть настоящий MCP-клиент, который управляет сервером от начала до конца (handshake → listTools → вызовы инструментов), так что вы можете проверить всё без редактора:

npm install
npm run build
npm run demo

Вывод:

=== 1. listTools ===
 • log_work — Append a timestamped entry...
 • search_diary — Full-text search across every entry...
 • daily_summary — Everything logged on a given date...
 • stats — Totals, active days, streaks, top tags...

=== 2. log_work x3 ===
Logged to 2026-08-22.md at 19:05 (tags: bugfix, websocket)
...

=== 5. stats ===
📊 1 entries across 2 day(s)
🔥 Streak: 2 consecutive day(s)
🏷️ Top tags: #bugfix (1), #websocket (1)

Затем посмотрите на diary/*.md — это ваши данные. Обычный Markdown.

Подключение к вашему редактору / агенту

Claude Desktop / Cursor / любой MCP-клиент

{
  "mcpServers": {
    "dev-diary": {
      "command": "node",
      "args": ["/absolute/path/to/dev-diary-mcp/dist/server.js"],
      "env": { "DIARY_DIR": "/absolute/path/to/your/diary" }
    }
  }
}

Hermes Agent

hermes mcp add dev-diary --command node --args /path/to/dist/server.js

Интерактивный просмотр

npx @modelcontextprotocol/inspector node dist/server.js

Формат хранения

Один файл на день (diary/YYYY-MM-DD.md), записи — заголовки H2 с встроенными тегами:

## 14:32 #bugfix #websocket
Fixed the race condition in the WebSocket broadcast queue

## 16:10 #testing
Wrote E2E test covering two-client sync

Поскольку это просто файлы, вы можете искать по ним grep'ом, делать резервные копии, редактировать вручную или коммитить. Сервер читает то, что есть на диске, при каждом вызове — никакого кэша, который нужно инвалидировать.

Как это работает (~строк TypeScript)

Создано с использованием официального SDK @modelcontextprotocol/server (спецификация от 2026-07-28):

• McpServer + registerTool(name, { description, inputSchema }, handler) — схемы соответствуют Standard Schema; в этом проекте используется Zod v4

• StdioServerTransport — редактор запускает процесс и общается через JSON-RPC по stdin/stdout

• Обработчики инструментов читают и пишут Markdown в каталоге DIARY_DIR (по умолчанию: ./diary)

Сопутствующая статья: «Я создал MCP-сервер, который ведёт мой рабочий журнал — вот что я узнал» (черновик в этом репозитории).

Лицензия

MIT