dev-diary-mcp

Model Context Protocol 서버로, 일반 Markdown 파일 폴더를 모든 LLM이 읽고 쓸 수 있는 검색 가능한 업무 일지로 바꿔줍니다.

데이터베이스도 없고, 앱도 없습니다. 작업 기록은 그저 diary/2026-08-22.md 하나입니다. 사람이 읽을 수 있고, diff도 가능하며, git 친화적입니다. 그리고 AI 어시스턴트는 이를 사용할 네 가지 도구를 제공받습니다:

왜

"오늘 내가 한 일을 기록하자"는 일주일이면 모두가 포기하는 과제입니다. 하지만 AI 어시스턴트는 당신이 무엇을 했는지 이미 알고 있습니다. 당신이 그 일을 하도록 도와줬으니까요. Markdown 폴더를 대상으로 도구를 제공하면, 업무 일지 작성은 AI와 함께 일하는 부산물이 됩니다.

데모 실행

이 저장소에는 서버를 엔드투엔드로 구동하는 실제 MCP 클라이언트가 포함되어 있습니다(핸드셰이크 → 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 약 190줄)

공식 @modelcontextprotocol/server SDK(2026-07-28 스펙)로 구축되었습니다:

• McpServer + registerTool(name, { description, inputSchema }, handler) — 스키마는 Standard Schema이며, 이 프로젝트는 Zod v4를 사용합니다.

• StdioServerTransport — 에디터가 프로세스를 생성하고 stdin/stdout을 통해 JSON-RPC로 통신합니다.

• 도구 핸들러는 DIARY_DIR(기본값: ./diary) 아래의 Markdown을 읽고 씁니다.

함께 보면 좋은 글: "업무 일지를 관리해 주는 MCP 서버를 만들었습니다 — 제가 배운 모든 것" (이 저장소에 초안이 있습니다).

라이선스

MIT