dev-diary-mcp

Markdownファイルのプレーンなフォルダを、LLMが読み書きできる検索可能な作業日誌に変えるModel Context Protocolサーバーです。

データベースもアプリも不要。あなたの作業ログは単なるdiary/2026-08-22.md — 人間が読めて、diffも取れて、gitとも相性抜群 — そしてAIアシスタントには4つのツールが提供されます：

なぜ作ったのか

「今日やったこと」を記録するのは、誰もが1週間で挫折するタスクです。しかし、あなたのAIアシスタントは、あなたがやったことをすでに知っています。Markdownフォルダに対してツールを提供すれば、作業日誌の記録はAIと一緒に働くことの副産物になります。

デモを実行する

このリポジトリには実際のMCPクライアントが同梱されており、サーバーをエンドツーエンドで駆動します（ハンドシェイク → ツール呼び出し）。エディタなしですべてを検証できます：

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

ストレージ形式

1日1ファイル（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も、バックアップも、手動編集も、コミットも自由自在。サーバーは呼び出しのたびにディスク上のデータを読み取るため、キャッシュの無効化を考える必要はありません。

仕組み（約190行のTypeScript）

公式の@modelcontextprotocol/serverSDK（2026-07-28仕様）で構築：

• McpServer + registerTool(name, { description, inputSchema }, handler) — スキーマはStandard Schema準拠。このプロジェクトではZod v4を使用

• StdioServerTransport — エディタがプロセスを起動し、stdin/stdoutでJSON-RPC通信を行う

• ツールハンドラはDIARY_DIR（デフォルト：./diary）配下のMarkdownを読み書き

関連記事：「私がMCPサーバーで作業日誌を管理する方法 — 学んだすべてのこと」（このリポジトリ内にドラフトあり）

ライセンス

MIT