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

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

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

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.