timesfm
TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.
Academic paper knowledge-base MCP server: PDF ingest, vector search with reranking, KB management.
Skills that teach the AI this kind of work; they work alongside this one
TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.
Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…
scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 9/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 7/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 17/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Scholar RAG MCP. Follow https://mcp.popnx.com/i/notwhiteblank-scholar-rag-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
3 setting(s) to fill in (SCHOLAR_RAG_CHAT_BASE_URL, SCHOLAR_RAG_EMBED_BASE_URL, SCHOLAR_RAG_RERANK_BASE_URL) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Scholar RAG MCP for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "scholar-rag": { "command": "uvx", "args": [ "scholar-rag-mcp" ], "env": { "SCHOLAR_RAG_CHAT_BASE_URL": "your-value", "SCHOLAR_RAG_EMBED_BASE_URL": "your-value", "SCHOLAR_RAG_RERANK_BASE_URL": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For SCHOLAR_RAG_CHAT_BASE_URL, SCHOLAR_RAG_EMBED_BASE_URL, SCHOLAR_RAG_RERANK_BASE_URL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Scholar RAG MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
SCHOLAR_RAG_CHAT_BASE_URL OpenAI-compatible chat endpoint for annotation/keywords (e.g. local vLLM)SCHOLAR_RAG_EMBED_BASE_URL OpenAI-compatible embeddings endpointSCHOLAR_RAG_RERANK_BASE_URL Rerank endpoint (/v1/rerank)Descriptions are as written by the maker.
SettingsDeveloperEdit Config
{
"mcpServers": {
"scholar-rag": {
"command": "uvx",
"args": [
"scholar-rag-mcp"
],
"env": {
"SCHOLAR_RAG_CHAT_BASE_URL": "your-value",
"SCHOLAR_RAG_EMBED_BASE_URL": "your-value",
"SCHOLAR_RAG_RERANK_BASE_URL": "your-value"
}
}
}
}Use Scholar RAG MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using Scholar RAG MCP or shows a Scholar RAG MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
SCHOLAR_RAG_DATA_DIR Data root directory (knowledge bases, caches, jobs)Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Scholar RAG MCP yet
Scholar RAG MCP runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Scholar RAG MCP
Works with Claude Code, with some setup first
3 setting(s) to fill in (SCHOLAR_RAG_CHAT_BASE_URL, SCHOLAR_RAG_EMBED_BASE_URL, SCHOLAR_RAG_RERANK_BASE_URL) · Install Python (uv) on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Scholar RAG MCP for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user scholar-rag --env SCHOLAR_RAG_CHAT_BASE_URL=your-value --env SCHOLAR_RAG_EMBED_BASE_URL=your-value --env SCHOLAR_RAG_RERANK_BASE_URL=your-value -- uvx scholar-rag-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For SCHOLAR_RAG_CHAT_BASE_URL, SCHOLAR_RAG_EMBED_BASE_URL, SCHOLAR_RAG_RERANK_BASE_URL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Scholar RAG MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
SCHOLAR_RAG_CHAT_BASE_URL OpenAI-compatible chat endpoint for annotation/keywords (e.g. local vLLM)SCHOLAR_RAG_EMBED_BASE_URL OpenAI-compatible embeddings endpointSCHOLAR_RAG_RERANK_BASE_URL Rerank endpoint (/v1/rerank)Descriptions are as written by the maker.
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user scholar-rag --env SCHOLAR_RAG_CHAT_BASE_URL=your-value --env SCHOLAR_RAG_EMBED_BASE_URL=your-value --env SCHOLAR_RAG_RERANK_BASE_URL=your-value -- uvx scholar-rag-mcpYou should see Scholar RAG MCP listed as connected
Use Scholar RAG MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Scholar RAG MCP or shows a Scholar RAG MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
SCHOLAR_RAG_DATA_DIR Data root directory (knowledge bases, caches, jobs)Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
3 setting(s) to fill in (SCHOLAR_RAG_CHAT_BASE_URL, SCHOLAR_RAG_EMBED_BASE_URL, SCHOLAR_RAG_RERANK_BASE_URL) · Install Python (uv) on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Scholar RAG MCP for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "scholar-rag": { "command": "uvx", "args": [ "scholar-rag-mcp" ], "env": { "SCHOLAR_RAG_CHAT_BASE_URL": "your-value", "SCHOLAR_RAG_EMBED_BASE_URL": "your-value", "SCHOLAR_RAG_RERANK_BASE_URL": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For SCHOLAR_RAG_CHAT_BASE_URL, SCHOLAR_RAG_EMBED_BASE_URL, SCHOLAR_RAG_RERANK_BASE_URL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Scholar RAG MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
SCHOLAR_RAG_CHAT_BASE_URL OpenAI-compatible chat endpoint for annotation/keywords (e.g. local vLLM)SCHOLAR_RAG_EMBED_BASE_URL OpenAI-compatible embeddings endpointSCHOLAR_RAG_RERANK_BASE_URL Rerank endpoint (/v1/rerank)Descriptions are as written by the maker.
In the Scholar RAG MCP settings, SCHOLAR_RAG_CHAT_BASE_URL, SCHOLAR_RAG_EMBED_BASE_URL, SCHOLAR_RAG_RERANK_BASE_URL is empty; add your key and save
Use Scholar RAG MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Scholar RAG MCP or shows a Scholar RAG MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
SCHOLAR_RAG_DATA_DIR Data root directory (knowledge bases, caches, jobs)Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
3 setting(s) to fill in (SCHOLAR_RAG_CHAT_BASE_URL, SCHOLAR_RAG_EMBED_BASE_URL, SCHOLAR_RAG_RERANK_BASE_URL) · Install Python (uv) on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Scholar RAG MCP for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "scholar-rag": { "type": "stdio", "command": "uvx", "args": [ "scholar-rag-mcp" ], "env": { "SCHOLAR_RAG_CHAT_BASE_URL": "your-value", "SCHOLAR_RAG_EMBED_BASE_URL": "your-value", "SCHOLAR_RAG_RERANK_BASE_URL": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For SCHOLAR_RAG_CHAT_BASE_URL, SCHOLAR_RAG_EMBED_BASE_URL, SCHOLAR_RAG_RERANK_BASE_URL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Scholar RAG MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
SCHOLAR_RAG_CHAT_BASE_URL OpenAI-compatible chat endpoint for annotation/keywords (e.g. local vLLM)SCHOLAR_RAG_EMBED_BASE_URL OpenAI-compatible embeddings endpointSCHOLAR_RAG_RERANK_BASE_URL Rerank endpoint (/v1/rerank)Descriptions are as written by the maker.
In the Scholar RAG MCP settings, SCHOLAR_RAG_CHAT_BASE_URL, SCHOLAR_RAG_EMBED_BASE_URL, SCHOLAR_RAG_RERANK_BASE_URL is empty; add your key and save
Use Scholar RAG MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Scholar RAG MCP or shows a Scholar RAG MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
SCHOLAR_RAG_DATA_DIR Data root directory (knowledge bases, caches, jobs)Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user scholar-rag --env SCHOLAR_RAG_CHAT_BASE_URL=your-value --env SCHOLAR_RAG_EMBED_BASE_URL=your-value --env SCHOLAR_RAG_RERANK_BASE_URL=your-value -- uvx scholar-rag-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"scholar-rag": {
"command": "uvx",
"args": [
"scholar-rag-mcp"
],
"env": {
"SCHOLAR_RAG_CHAT_BASE_URL": "your-value",
"SCHOLAR_RAG_EMBED_BASE_URL": "your-value",
"SCHOLAR_RAG_RERANK_BASE_URL": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"scholar-rag": {
"command": "uvx",
"args": [
"scholar-rag-mcp"
],
"env": {
"SCHOLAR_RAG_CHAT_BASE_URL": "your-value",
"SCHOLAR_RAG_EMBED_BASE_URL": "your-value",
"SCHOLAR_RAG_RERANK_BASE_URL": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"scholar-rag": {
"type": "stdio",
"command": "uvx",
"args": [
"scholar-rag-mcp"
],
"env": {
"SCHOLAR_RAG_CHAT_BASE_URL": "your-value",
"SCHOLAR_RAG_EMBED_BASE_URL": "your-value",
"SCHOLAR_RAG_RERANK_BASE_URL": "your-value"
}
}
}
}SCHOLAR_RAG_DATA_DIR envSCHOLAR_RAG_CHAT_BASE_URL required envSCHOLAR_RAG_EMBED_BASE_URL required envSCHOLAR_RAG_RERANK_BASE_URL required envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
The registry name was verified with the GitHub account notwhiteblank, which owns the repo
Code last changed 3 months ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
No entries on OSV.dev for scholar-rag-mcp@0.4.0
Checks only this package version, not every dependency · checked Nov 15, 2026
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/notwhiteblank-scholar-rag-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 3 months ago, and the latest version (0.4.0) reached the registry 3 months ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.
In the same category: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Keyword research, site audits, rank tracking and AI visibility for your AI agent.
Connect AI agents to Exa for web search, content fetching, and multi-step research.
Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.
Search and read Empryo's documentation. Read-only, no auth, no local access.
cotal.ai actions: product overview, site search, build log, feedback, Cloud waitlist, updates, calls
| This one Scholar RAG MCP | OpenSEO | Exa | Microsoft Learn MCP | Docs | COTAL actions (cotal.ai) | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | No | No | No | No | No | No |
| Add with + in Claude | No | Yes | Yes | Yes | No | No |
| Basic checks | 3/3 | 5/5 | 2/4 | 4/4 | 4/4 | 4/4 |
| License | MIT | MIT | MIT | CC-BY-4.0 | NOASSERTION | Apache-2.0 |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
Status: preview release (v0.4.0). Interfaces and storage layout may change in future versions.
scholar-rag-mcp is a publishable academic-paper knowledge-base MCP tool. Point it at a folder of PDFs and it ingests each paper through a real parsing pipeline (MinerU), normalizes metadata, annotates section structure, chunks and embeds the text, and stores everything in Qdrant - after which an agent (or you) can semantically search chunks, run PubMed-style document queries, read full text section by section, add/remove single papers, and manage knowledge bases - all through 11 MCP tools over stdio. Embedding, annotation and re-ranking run on OpenAI-compatible model services (e.g. vLLM).
doc_id, section, year, journal, ...) evaluated inside the Qdrant index. 100k-chunk p95 query latency < 1s (see docs/perf-report.md).create_kb/add_document are background jobs with progress queryable via get_job; safe to restart (interrupted jobs are recovered and skipped on re-run).get_document_text with hard size caps; *outline first, pages on demand*.list_kbs, create_kb, delete_kb (two-phase), add_document, remove_document, get_document, get_document_text, list_documents, search_documents, search_chunks, get_job.scholar-rag-mcp runs on Linux x64, Windows x64 and macOS (Intel and Apple Silicon). It is published on PyPI; the standard way to run it is with uv (a suitable Python 3.12 is fetched automatically):
uvx scholar-rag-mcp # download and start the MCP server (stdio)
No repository checkout is needed. Configure model endpoints and storage with SCHOLAR_RAG_* environment variables or /config.json (see .env.example); the Qdrant binary used for auto-launch is downloaded per platform on first use.
uvx scholar-rag-mcp install --with-mineru # install via uv, provision managed MinerU, register MCP clients
uvx scholar-rag-mcp install # MCP only; bring your own parse service (see PDF parsing) scholar-rag-mcp uninstall # unregister clients and remove the package
uvx scholar-rag-mcp install installs the package via uv tool install and interactively walks through the six model-endpoint settings (chat/embed/rerank base URLs and model names), using the defaults listed in Minimal environment unless a SCHOLAR_RAG_* value or a --chat-base-url / --chat-model / --embed-base-url / --embed-model / --rerank-base-url / --rerank-model flag is given; --yes accepts all defaults without prompting. It then detects the four supported MCP clients (Claude Desktop, Claude Code, opencode, Codex) and registers the tool by merging the scholar-rag-mcp entry into their user-level configs, touching only that entry; pass --client to register a single client. Configs that cannot be parsed (e.g. JSON with comments) are left untouched and a manual snippet is printed instead.
scholar-rag-mcp uninstall removes the scholar-rag-mcp entry from the detected clients and runs uv tool uninstall; the knowledge-base data directory is kept. --purge additionally deletes the data directory after explicit confirmation (skip the prompt with --yes).
Requires pixi. From the repository root:
pixi install # installs the default environment
The pixi environments are locked for all four supported targets. The project defines two pixi environments, each serving a different purpose:
| Environment | Purpose |
|---|---|
default | Core runtime + dev tooling (pytest/ruff/mypy). Run the MCP server and all scripts here. |
mineru | Adds MinerU (==3.4.5) plus its full runtime stack (pinned transformers<5, torch, onnxruntime, shapely, ...). Use for PDF parsing and the e2e smoke test. |
Verify your environment with the built-in doctor:
pixi run python scripts/doctor.py
Environment ('chat', 'embed' and 'rerank' clients) expects OpenAI-compatible HTTP endpoints. scripts/serve_models.sh launches three vLLM instances for the reference model set:
| Service | Model | Port |
|---|---|---|
| chat | Qwen3.5-0.8B | 8101 |
| embed | jina-embeddings-v5-text-small | 8102 |
| rerank | jina-reranker-v3.5 | 8103 |
# point *_MODEL at your local model directories, then:
bash scripts/serve_models.sh
SCHOLAR_RAG_CHAT_MODEL, SCHOLAR_RAG_EMBED_MODEL and SCHOLAR_RAG_RERANK_MODEL are required - the script exits with a message listing them if any is unset. Each value must be an absolute path to a local HuggingFace model directory; vLLM serves each model under a short name equal to the directory basename, so the client settings must use that short name (the served name no longer equals the full path). Replace the /path/to/... placeholders in .env.example accordingly. Ports (CHAT_PORT/EMBED_PORT/RERANK_PORT) and GPU ids remain optional with working defaults.
The script passes the vLLM flags verified for the default model set, notably --trust-remote-code, which all three models require on the pinned vLLM (0.27.1). Model load takes several minutes; the script polls health until all three answer.
scripts/serve_models.sh is Linux-only (bash + CUDA + vLLM; vLLM has no Windows support). On Windows/macOS point the *_BASE_URL settings at any OpenAI-compatible server instead - for example Ollama (http://127.0.0.1:11434/v1), LM Studio's local server, or a llama.cpp server - and set each *_MODEL to the model name that server reports. The rerank endpoint must expose /v1/rerank (or leave reranking to the embed-only fallback).
Start from .env.example and set at least the model endpoints (use the short names the serve script exposes, equal to each model directory's basename):
# data dir is optional - defaults to the platform data directory (see Data layout)
SCHOLAR_RAG_CHAT_BASE_URL=http://127.0.0.1:8101/v1 SCHOLAR_RAG_CHAT_MODEL=Qwen3.5-0.8B
SCHOLAR_RAG_EMBED_BASE_URL=http://127.0.0.1:8102/v1 SCHOLAR_RAG_EMBED_MODEL=jina-embeddings-v5-text-small
SCHOLAR_RAG_RERANK_BASE_URL=http://127.0.0.1:8103/v1 SCHOLAR_RAG_RERANK_MODEL=jina-reranker-v3.5
The embed model dimension is recorded in kb_meta.json at kb creation, so changing the embedding model later requires a new kb.
Since v0.4.0 the default parse backend is api. The recommended setup is the managed sidecar, which installs MinerU into an isolated Python 3.12 venv (MinerU requires Python >=3.10,<3.14) and auto-starts mineru-api on first parse:
scholar-rag-mcp install --with-mineru
The first parse triggers MinerU's model download; set MINERU_MODEL_SOURCE=modelscope if you need a China-friendly mirror.
Self-managed alternative: install MinerU in any Python 3.12 environment, run mineru-api --host 127.0.0.1 --port 8010, and keep the defaults (SCHOLAR_RAG_MINERU_BACKEND=api, SCHOLAR_RAG_MINERU_API_URL=http://127.0.0.1:8010).
The python backend (in-process import) and cli backend (subprocess per file) remain available via SCHOLAR_RAG_MINERU_BACKEND.
Point your MCP client at the uvx entry point and configure the model endpoints in the env block (any OpenAI-compatible server works; see Model deployment). To check that the server starts, run uvx scholar-rag-mcp in a terminal - it waits for an MCP client on stdio (Ctrl+C to exit).
{
"mcpServers": { "scholar-rag-mcp": { "command": "uvx", "args": ["scholar-rag-mcp"], "env": { "SCHOLAR_RAG_CHAT_BASE_URL": "http://127.0.0.1:8101/v1", "SCHOLAR_RAG_CHAT_MODEL": "Qwen3.5-0.8B", "SCHOLAR_RAG_EMBED_BASE_URL": "http://127.0.0.1:8102/v1", "SCHOLAR_RAG_EMBED_MODEL": "jina-embeddings-v5-text-small", "SCHOLAR_RAG_RERANK_BASE_URL": "http://127.0.0.1:8103/v1", "SCHOLAR_RAG_RERANK_MODEL": "jina-reranker-v3.5" } } } }
{
"$schema": "https://opencode.ai/config.json", "mcp": { "scholar-rag-mcp": { "type": "local", "command": ["uvx", "scholar-rag-mcp"], "environment": { "SCHOLAR_RAG_CHAT_BASE_URL": "http://127.0.0.1:8101/v1", "SCHOLAR_RAG_CHAT_MODEL": "Qwen3.5-0.8B", "SCHOLAR_RAG_EMBED_BASE_URL": "http://127.0.0.1:8102/v1", "SCHOLAR_RAG_EMBED_MODEL": "jina-embeddings-v5-text-small", "SCHOLAR_RAG_RERANK_BASE_URL": "http://127.0.0.1:8103/v1", "SCHOLAR_RAG_RERANK_MODEL": "jina-reranker-v3.5" } } } }
Running from a source checkout instead: use pixi run scholar-rag-mcp as the command (from the repository root) and set the same variables in your shell.
| Tool | Purpose |
|---|---|
list_kbs | List knowledge bases with document/chunk counts and status. |
create_kb | Asynchronously ingest every PDF in a folder into a new kb (returns job_id). |
delete_kb | Two-phase kb deletion (see below). |
add_document | Asynchronously ingest a single PDF into an existing kb (returns job_id). |
remove_document | Synchronously delete one document (Qdrant points + catalog + files). |
get_document | Document overview: metadata, abstract, section outline, total size. |
get_document_text | Paginated full-text reading of one document or a single section. |
list_documents | Paginated browse of documents in a kb. |
search_documents | PubMed-style document-level search (FTS + title/authors/journal/year). |
search_chunks | Semantic chunk search with metadata filters and embed+rerank scores. |
get_job | Query status/progress/result/elapsed time of a background job. |
<data_dir>/ # SCHOLAR_RAG_DATA_DIR, default: platform data dir (below)
├── kbs/ / │ ├── kb_meta.json # dimension, chunk config, schema version │ ├── catalog.sqlite3 # documents / authors / keywords / chunks + FTS5 │ └── documents/ / # source.pdf, full_text.md, sections.json ├── cache/parse/ # MinerU markdown cache, keyed by content hash ├── cache/resolver/ # annotation resolver cache, keyed by content hash ├── jobs.sqlite3 # async job history ├── bin/ # auto-downloaded Qdrant binary (v1.12.5) └── qdrant-storage/ # default QDRANT_STORAGE_DIR location
Default data_dir per platform (override with SCHOLAR_RAG_DATA_DIR):
| Platform | Default |
|---|---|
| Linux | $XDG_DATA_HOME/scholar-rag (falls back to ~/.local/share/scholar-rag) |
| macOS | ~/Library/Application Support/scholar-rag |
| Windows | %LOCALAPPDATA%\scholar-rag |
Qdrant storage defaults to /qdrant-storage (override with SCHOLAR_RAG_QDRANT_STORAGE_DIR) - it must be on a local filesystem, not a 9p/network mount.
Upgrading from v0.1.0 on Linux: the old defaults (~/.scholar-rag and ~/.local/share/scholar-rag/qdrant) are migra