# Caelune

Windows-based local retrieval engine for Markdown notes, Logseq data, and PDFs. It equips AI clients with private search tools without exposing raw files online.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 45
- Author: EllisMorrow
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/EllisMorrow/Caelune
- Updated: 2026-08-08
- HTML: https://affpapa.org/en/nevibecode/mcp/caelune

## What it does

Caelune links exact text matching via SQLite FTS5 with vector similarity through LanceDB and `BAAI/bge-m3`. It handles regular Markdown files alongside Logseq embeds and block properties. An extension pipeline extracts text from PDF documents and formats handled by Apache Tika, with optional reranking via `BAAI/bge-reranker-v2-m3`.

The MCP server operates strictly read-only. It exposes two tools for inspection and queries, but cannot generate or alter indexes on its own. You must assemble your initial knowledge base inside the 64-bit Windows desktop application first.

A background watcher detects file changes and schedules incremental updates inside disposable worker processes. Retrieval runs either on CPU or NVIDIA CUDA hardware, with automatic fallbacks whenever system RAM or GPU memory gets low.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- retrieve factual snippets from local Markdown and Logseq vaults
- query private PDF documents without third-party cloud uploads
- feed verified source citations into AI coding sessions
- sync modified desktop notes into the search index in the background

## Example prompts
- Look up our deployment checklist in my local Logseq notes
- Find references to database schemas inside the archived PDF files
- Search my private knowledge base for notes on API error handling

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md