Scholar RAG MCP

Name: Scholar RAG MCP
Author: notwhiteblank

notwhiteblank

Builds a knowledge base from academic PDFs with MinerU parsing and Qdrant vector search with reranking, and supports paginated full-text reading.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

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>"
      }
    }
  }
}

Environment variables

SCHOLAR_RAG_CHAT_BASE_URL
SCHOLAR_RAG_EMBED_BASE_URL
SCHOLAR_RAG_RERANK_BASE_URL

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related