About Aitherflow Knowledge
Aitherflow Knowledge is an MCP server published by aitherlab-dev in the RAG category: mCP server for RAG knowledge base search — local embeddings (fastembed/ONNX) + vector search (LanceDB).
The repository has 2 stars and 0 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/aitherlab-dev/aitherflow-knowledgeThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (4)
get_document_infoGet metadata for a specific document
Parameters not published.
list_knowledge_basesList all available knowledge bases
Parameters not published.
reindex_documentRe-embed and reindex a document
Parameters not published.
search_knowledge_baseSemantic search across a knowledge base — returns relevant document chunks
Parameters not published.
Ask AI
Ask AI about Aitherflow Knowledge
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
aitherflow-knowledge
MCP server for RAG (Retrieval-Augmented Generation) knowledge base search. Local embeddings, local vector search, no API keys needed.
What it does
A stdio-based Model Context Protocol server that gives Claude agents access to your knowledge bases. Documents are embedded locally via fastembed (ONNX runtime) and stored in LanceDB for fast vector search.
Knowledge bases are created and managed through the aitherflow desktop app. This MCP server provides read and search access to them.
Tools
| Tool | Description |
|---|---|
search_knowledge_base |
Semantic search across a knowledge base — returns relevant document chunks |
list_knowledge_bases |
List all available knowledge bases |
get_document_info |
Get metadata for a specific document |
reindex_document |
Re-embed and reindex a document |
Document parsers
- PDF — text extraction via
pdftotext, fallback topdf-extract, OCR fallback for scanned pages - EPUB — full content extraction
- TXT / Markdown — plain text, chunked for embedding
OCR
Scanned PDFs are handled via PP-OCR ONNX models (Latin + Cyrillic). Models are downloaded automatically on first use. Pages are rendered to images with pdftoppm, then recognized.
Embedding models
| Model | Languages | Size |
|---|---|---|
all-MiniLM-L6-v2 (default) |
English | 23 MB |
multilingual-e5-small |
100+ languages | 118 MB |
multilingual-e5-large |
100+ languages | 560 MB |
nomic-embed-text-v1.5 |
English | 137 MB |
bge-m3 |
100+ languages | 567 MB |
Models are downloaded on first use and cached locally by ONNX runtime.
Prerequisites
- Rust 1.75+
poppler-utils— providespdftotext,pdftoppm,pdfinfo(required for PDF parsing and OCR)
Install poppler-utils:
# Arch / Manjaro
sudo pacman -S poppler
# Ubuntu / Debian
sudo apt install poppler-utils
# macOS
brew install poppler
Build
cargo build --release
This will take a while on first build — fastembed and ONNX runtime are large dependencies.
Install
Register the MCP server in Claude Code:
claude mcp add --scope user aitherflow-knowledge /path/to/target/release/aitherflow-knowledge
For Claude Desktop, add to your config:
{
"mcpServers": {
"aitherflow-knowledge": {
"command": "/path/to/target/release/aitherflow-knowledge"
}
}
}
Works with any MCP client that supports stdio transport.
Data locations
| Path | Contents |
|---|---|
~/.local/share/aither-flow/rag/ |
Knowledge base data (LanceDB tables, document metadata) |
~/.local/share/aither-flow/rag/settings.json |
RAG settings (embedding model, chunk size, etc.) |
Usage
Once registered, ask any Claude agent:
"Search my knowledge base for information about vector databases"
"What documents are in my knowledge base?"
"Reindex the file report.pdf"
Part of aitherflow
This is a companion MCP server for aitherflow — a desktop GUI wrapper for Claude Code CLI by aitherlab-dev.
License
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.