mdlog-mcp

MCP (Model Context Protocol) server for searching date-organized markdown logs — daily digests, journals, meeting notes, or any markdown corpus where dates live in filenames or directory names.

Point it at a directory and ask your AI agent things like "What did my digest say about Next.js caching back in May?" — the agent finds it via full-text search instead of you grepping by hand.

Recognized layouts

Any markdown file whose date appears in the filename or a parent directory name becomes an entry:

logs/
├── 2026-04-24-ai-web-dev-digest.md        # date in filename
├── 2026-08-10/
│   ├── ai-web-dev-digest.md               # date in directory name
│   └── infra-security-data-digest.md
└── weekly/
    └── 2026-08-10-weekly-review.md        # works in subdirectories too

• date: YYYY-MM-DD from the filename prefix or the nearest dated directory (must be a real calendar date)

• slug: the rest of the filename (e.g. ai-web-dev-digest) — acts as the entry type

• category: the subdirectory (e.g. weekly), with date directories stripped

• Undated markdown files are ignored and cannot be read through the tools

• Symlinks inside the directory are never followed

Related MCP server: brain-mcp

Tools

All tools are read-only.

Every tool supports response_format: "markdown" | "json" (where applicable) and returns structuredContent alongside text.

Setup

Requires Node.js >= 20.

Claude Code

claude mcp add --scope user mdlog -- npx -y @yamk12nfu/mdlog-mcp --dir /path/to/your/logs

Or from a local checkout:

npm install && npm run build
claude mcp add --scope user mdlog -- node /path/to/mdlog-mcp/dist/index.js --dir /path/to/your/logs

Claude Desktop / other MCP clients

{
  "mcpServers": {
    "mdlog": {
      "command": "npx",
      "args": ["-y", "@yamk12nfu/mdlog-mcp", "--dir", "/path/to/your/logs"]
    }
  }
}

The target directory can also be set via the MDLOG_DIR environment variable instead of --dir.

Example prompts

Once connected, ask your agent:

• "5月ごろのダイジェストで Next.js のキャッシュの話なかったっけ？"

• "What security incidents were covered in my digests between June and July?"

• "Summarize the last three weekly reviews."

Development

npm install
npm run build       # compile to dist/
npm run test        # run the test suite (node:test via tsx)
npm run dev         # run from src/ with tsx
node dist/index.js --dir ./sample-logs

Debug interactively with the MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js --dir /path/to/your/logs

License

MIT