Study Prep MCP Server

MCP tools to browse and prepare study materials from a local document folder — PDF, Markdown, plain text, and Word files.

The server extracts text and structure locally; your MCP client (e.g. Cursor) generates summaries and practice questions from the returned content.

Tools

| Tool | What it does | |------|----------------| | get_corpus_overview | Categories, file counts, sizes, supported extensions | | list_documents | List files with optional category or glob filter | | read_document | Read or extract text from one file (PDF page range supported) | | search_documents | Full-text search with snippet context | | extract_key_terms | Keyword extraction via YAKE (one doc or whole category) | | get_document_outline | Headings / outline for structured review | | get_study_chunks | Split long docs into numbered study chunks | | prepare_study_session | Bundle excerpts, key terms, and AI prompts for a topic | | get_quiz_source_material | Labeled excerpts + instructions for Q&A generation |

Quick start

git clone https://github.com/YOUR_ORG/study-md-mcp.git
cd study-md-mcp

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

# Smoke test on stdio (Ctrl+C to stop)
MD_DOCS_PATH=/path/to/your/study-documents python server.py

Or with uv:

git clone https://github.com/YOUR_ORG/study-md-mcp.git
cd study-md-mcp

uv venv && uv pip install -e .
MD_DOCS_PATH=/path/to/your/study-documents uv run server.py

Environment variables

| Variable | Default | Purpose | |----------|---------|---------| | MD_MCP_NAME | study-md | FastMCP server name | | MD_DOCS_PATH | . | Root folder for study documents |

Set MD_DOCS_PATH to the folder containing your study files. On WSL with Windows files, use the /mnt/c/... path.

Connect to Cursor

Copy examples/cursor-mcp-config.json and adjust paths:

{
  "mcpServers": {
    "study-md": {
      "command": "/path/to/study-md-mcp/.venv/bin/python",
      "args": ["/path/to/study-md-mcp/server.py"],
      "env": {
        "MD_MCP_NAME": "study-md",
        "MD_DOCS_PATH": "/path/to/your/study-documents"
      }
    }
  }
}

Then ask Cursor to use study-md tools, e.g. “Search my study docs for essay requirements” or “Prepare a study session on offer terms.”

Connect to Claude Desktop (Windows + WSL)

If Claude Desktop runs on Windows but documents live in WSL, see examples/claude-desktop-config.json.

Connect to Claude CLI

claude mcp add study-md \
  -e MD_MCP_NAME=study-md \
  -e MD_DOCS_PATH=/path/to/your/study-documents \
  -- /path/to/study-md-mcp/.venv/bin/python /path/to/study-md-mcp/server.py

Supported formats

| Extension | Method | |-----------|--------| | .md, .txt | Direct UTF-8 read | | .pdf | Text extraction via PyMuPDF | | .docx | Paragraph text via python-docx |

Scanned/image-only PDFs are not supported (no OCR).

Document layout

Organize files under MD_DOCS_PATH by category subfolder:

study-documents/
├── notes/
├── exams/
├── essays/
└── reference/

Empty category folders appear in get_corpus_overview with count 0.

License

MIT — see LICENSE.