md-manager MCP Server

An MCP (Model Context Protocol) server that enables Claude Code CLI to interact with your md-manager knowledge base.

• search_notes - Full-text search across your knowledge base using BM25 ranking
• get_note - Retrieve the full content of a specific note
• list_notes - List notes with optional filtering (by root, recency)
• list_roots - List all watched directories in the knowledge base

Prerequisites

• Node.js 18+
• An existing md-manager installation with an SQLite database

Setup

1. Navigate to the MCP server directory:

   cd md-manager-mcp-server
   npm install
   npm run build

2. Add to your Claude Code settings (~/.claude/settings.json):

   {
     "mcpServers": {
       "md-manager": {
         "command": "node",
         "args": ["C:/path/to/md-manager/md-manager-mcp-server/dist/index.js"],
         "env": {
           "SQLITE_PATH": "C:/path/to/md-manager/data/index.sqlite"
         }
       }
     }
   }

   Or using npx (once published):

   {
     "mcpServers": {
       "md-manager": {
         "command": "npx",
         "args": ["-y", "md-manager-mcp-server"],
         "env": {
           "SQLITE_PATH": "C:/path/to/md-manager/data/index.sqlite"
         }
       }
     }
   }

3. Restart Claude Code CLI

Once configured, Claude Code can use the following tools:

search_notes

Search your knowledge base with natural language:

"Search my notes for cloud architecture"
"Find notes about authentication"
"What documents mention API design?"

get_note

Retrieve a specific note:

"Get the note at path/to/my-note.md"
"Show me note ID 42"

list_notes

Browse your knowledge base:

"List my recent notes from the last 7 days"
"Show me notes in the project-x folder"
"List all notes"

list_roots

See what directories are being watched:

"What directories are in my knowledge base?"

| Variable | Description | Required | |----------|-------------|----------| | SQLITE_PATH | Path to md-manager's SQLite database | Yes |

The database is typically located at {md-manager-root}/data/index.sqlite.

Running in Development

npm run dev

Building

npm run build

Testing

Test database connection:

SQLITE_PATH="path/to/index.sqlite" node dist/index.js

md-manager-mcp-server/
├── src/
│   ├── index.ts           # Entry point, MCP server initialization
│   ├── database/
│   │   └── SqliteAdapter.ts  # SQLite database adapter
│   ├── tools/
│   │   └── index.ts       # MCP tool registrations
│   └── types/
│       └── index.ts       # TypeScript type definitions
├── package.json
├── tsconfig.json
└── README.md

The server connects to the existing md-manager SQLite database in read-only mode and provides MCP tools for searching and browsing notes.

Planned for future phases:

• Semantic search with vector embeddings (Gemini)
• Cloud sync tools (push/pull to Neon PostgreSQL + GCS)
• AI memory storage and retrieval
• Document curation tools (enhance, build knowledge graph)
• MCP resources for accessing notes as context
• MCP prompts for common tasks (weekly summary, context for task)

License

MIT