Builds a knowledge base from academic PDFs with MinerU parsing and Qdrant vector search with reranking, and supports paginated full-text reading.
接入配置
选择客户端，复制配置，再按项目文档补齐环境变量。
claude mcp add scholar-rag --env SCHOLAR_RAG_CHAT_BASE_URL='<SCHOLAR_RAG_CHAT_BASE_URL>' --env SCHOLAR_RAG_EMBED_BASE_URL='<SCHOLAR_RAG_EMBED_BASE_URL>' --env SCHOLAR_RAG_RERANK_BASE_URL='<SCHOLAR_RAG_RERANK_BASE_URL>' -- uvx scholar-rag-mcp~/.codex/config.toml
[mcp_servers.scholar-rag]
command = "uvx"
args = ["scholar-rag-mcp"]
env = { SCHOLAR_RAG_CHAT_BASE_URL = "<SCHOLAR_RAG_CHAT_BASE_URL>", SCHOLAR_RAG_EMBED_BASE_URL = "<SCHOLAR_RAG_EMBED_BASE_URL>", SCHOLAR_RAG_RERANK_BASE_URL = "<SCHOLAR_RAG_RERANK_BASE_URL>" }
# codex mcp add scholar-rag --env SCHOLAR_RAG_CHAT_BASE_URL='<SCHOLAR_RAG_CHAT_BASE_URL>' --env SCHOLAR_RAG_EMBED_BASE_URL='<SCHOLAR_RAG_EMBED_BASE_URL>' --env SCHOLAR_RAG_RERANK_BASE_URL='<SCHOLAR_RAG_RERANK_BASE_URL>' -- uvx scholar-rag-mcp~/.cursor/mcp.json
{
"mcpServers": {
"scholar-rag": {
"command": "uvx",
"args": [
"scholar-rag-mcp"
],
"env": {
"SCHOLAR_RAG_CHAT_BASE_URL": "<SCHOLAR_RAG_CHAT_BASE_URL>",
"SCHOLAR_RAG_EMBED_BASE_URL": "<SCHOLAR_RAG_EMBED_BASE_URL>",
"SCHOLAR_RAG_RERANK_BASE_URL": "<SCHOLAR_RAG_RERANK_BASE_URL>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"scholar-rag": {
"type": "stdio",
"command": "uvx",
"args": [
"scholar-rag-mcp"
],
"env": {
"SCHOLAR_RAG_CHAT_BASE_URL": "<SCHOLAR_RAG_CHAT_BASE_URL>",
"SCHOLAR_RAG_EMBED_BASE_URL": "<SCHOLAR_RAG_EMBED_BASE_URL>",
"SCHOLAR_RAG_RERANK_BASE_URL": "<SCHOLAR_RAG_RERANK_BASE_URL>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"scholar-rag": {
"command": "uvx",
"args": [
"scholar-rag-mcp"
],
"env": {
"SCHOLAR_RAG_CHAT_BASE_URL": "<SCHOLAR_RAG_CHAT_BASE_URL>",
"SCHOLAR_RAG_EMBED_BASE_URL": "<SCHOLAR_RAG_EMBED_BASE_URL>",
"SCHOLAR_RAG_RERANK_BASE_URL": "<SCHOLAR_RAG_RERANK_BASE_URL>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"scholar-rag": {
"command": "uvx",
"args": [
"scholar-rag-mcp"
],
"env": {
"SCHOLAR_RAG_CHAT_BASE_URL": "<SCHOLAR_RAG_CHAT_BASE_URL>",
"SCHOLAR_RAG_EMBED_BASE_URL": "<SCHOLAR_RAG_EMBED_BASE_URL>",
"SCHOLAR_RAG_RERANK_BASE_URL": "<SCHOLAR_RAG_RERANK_BASE_URL>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"scholar-rag": {
"command": "uvx",
"args": [
"scholar-rag-mcp"
],
"env": {
"SCHOLAR_RAG_CHAT_BASE_URL": "<SCHOLAR_RAG_CHAT_BASE_URL>",
"SCHOLAR_RAG_EMBED_BASE_URL": "<SCHOLAR_RAG_EMBED_BASE_URL>",
"SCHOLAR_RAG_RERANK_BASE_URL": "<SCHOLAR_RAG_RERANK_BASE_URL>"
}
}
}
}需要的环境变量
SCHOLAR_RAG_CHAT_BASE_URLSCHOLAR_RAG_EMBED_BASE_URLSCHOLAR_RAG_RERANK_BASE_URL
把占位值换成你自己的密钥；不要把密钥提交到代码仓库。