Study Prep MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Study Prep MCP Server Get an overview of my study documents"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Categories, file counts, sizes, supported extensions |
| List files with optional category or glob filter |
| Read or extract text from one file (PDF page range supported) |
| Full-text search with snippet context |
| Keyword extraction via YAKE (one doc or whole category) |
| Headings / outline for structured review |
| Split long docs into numbered study chunks |
| Bundle excerpts, key terms, and AI prompts for a topic |
| Labeled excerpts + instructions for Q&A generation |
Related MCP server: Mind Forge
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.pyOr 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.pyEnvironment variables
Variable | Default | Purpose |
|
| FastMCP server name |
|
| 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.pySupported formats
Extension | Method |
| Direct UTF-8 read |
| Text extraction via PyMuPDF |
| 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.
Available Tools
9 toolsextract_key_termsB
Extract keywords from one document or an entire category using YAKE.
Args:
relative_path: Optional single file path relative to docs root
category: Optional category folder when relative_path is not set
top_n: Number of terms to return (default 20)
Inputs: relative_path, category, top_n. Returns: result
get_corpus_overviewA
Return categories, file counts, total size, and supported extensions in the corpus.
Inputs: no named parameters. Returns: result
get_document_outlineA
Return document outline from markdown headings or heading-like lines.
Args:
relative_path: Path relative to docs root
Inputs: relative_path (required). Returns: result
get_quiz_source_materialB
Return labeled excerpts and instructions for generating practice Q&A.
Args:
relative_path: Optional single file path relative to docs root
topic: Optional search topic when relative_path is not set
num_excerpts: Number of excerpts to include (default 5)
Inputs: relative_path, topic, num_excerpts. Returns: result
get_study_chunksA
Split a document into numbered study-sized chunks.
Args:
relative_path: Path relative to docs root
chunk_chars: Target chunk size in characters (default 3000)
overlap: Overlap between consecutive chunks (default 200)
Inputs: relative_path (required), chunk_chars, overlap. Returns: result
list_documentsA
List study documents with relative path, size, and type.
Args:
category: Optional subfolder name (e.g. lpdp, uwa, learn)
pattern: Optional glob matched against relative path (e.g. *.pdf, lpdp/*)
Inputs: category, pattern. Returns: result
prepare_study_sessionB
Bundle excerpts, key terms, and suggested AI prompts for a study topic.
Args:
topic: Study topic or search query
categories: Comma-separated category folders to search (empty = all)
paths: Comma-separated relative file paths to include directly
max_chars: Maximum total characters in the bundle (default 12000)
Inputs: topic (required), categories, paths, max_chars. Returns: result
read_documentA
Read or extract text from a study document.
Args:
relative_path: Path relative to docs root, e.g. lpdp/essay.pdf
max_chars: Maximum characters to return (default 50000)
page_start: PDF only — 1-based start page (0 = from beginning)
page_end: PDF only — 1-based end page inclusive (0 = through last page)
Inputs: relative_path (required), max_chars, page_start, page_end. Returns: result
search_documentsA
Search document text with snippet context around each match.
Args:
query: Case-insensitive search string
category: Optional subfolder filter
max_results: Maximum number of matching files (default 10)
Inputs: query (required), category, max_results. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a unique aspect of study preparation, such as document overview, reading, chunking, keyword extraction, quiz generation, and session bundling. There is no overlap in functionality, making it easy for an agent to select the correct tool.
All tool names follow a consistent verb_noun pattern with snake_case, e.g., 'extract_key_terms', 'get_document_outline', 'list_documents'. The naming is predictable and clear throughout.
With 9 tools, the set is well-scoped for study preparation. Each tool serves a distinct purpose without redundancy, covering corpus management, document processing, and content generation.
The tool set covers all common study needs: browsing documents, reading with pagination, extracting outlines, chunking, keyword extraction, quiz material generation, and full session preparation. There are no obvious missing operations like adding or deleting documents, but the server appears to be a read-only study aid, so this is appropriate.
Maintenance
Related MCP Connectors
Convert PDFs, Office docs, websites and audio into AI-ready Markdown, then search and ask your docs.
Build study flashcards and exam-prep decks from your AI chat, all stored locally.
Turn any recording or document into notes, flashcards and quizzes your agent can read and act on
Turn books in your private library into tables of contents, summaries and study docs.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables personalized AI tutoring by allowing students to upload PDF/DOCX study materials that are processed and indexed for semantic search. Provides intelligent responses based on the student's own learning materials using RAG technology.-
- AlicenseNot gradedqualityDmaintenanceIngest, query, and generate study materials from documents (PDF, DOCX, Markdown, images, web pages) using vector search, knowledge graph, and study tools through OpenCode chat.MIT
- AlicenseNot gradedqualityDmaintenanceConverts study materials like PDFs, slides, and DOCX into a searchable vector database with semantic search, summarization, and flashcard generation, integrated with Notion.5MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with local documents (PDF, Markdown, TXT) through tools for discovery, reading, extraction, summarization, comparison, keyword extraction, search, and analysis, ensuring privacy and offline capability.-