mcp-md-fileserver

wlanboy/mcp-md-fileserver

3.1

If you are the rightful owner of mcp-md-fileserver and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The MCP Markdown File Server is a FastMCP-compliant Python server designed to efficiently manage and retrieve Markdown files using NLP and SQLite.

MCP Markdown File Server

A FastMCP-compliant Python server that scans Markdown files, extracts subject/verb keywords using spaCy, stores metadata in SQLite, and exposes endpoints for keyword-based search and content retrieval.

Features

  • Periodic scan of a folder for .md files
  • NLP keyword extraction (subjects & verbs only)
  • SQLite-based metadata storage
  • MCP endpoints for:
    • POST /search → Find files by keywords
    • POST /content → Return file contents (Markdown or JSON)

Installation (with uv)

curl -LsSf https://astral.sh/uv/install.sh | sh

Install dependencies

uv sync
uv run -- spacy download en_core_web_sm #for english md files
uv run -- spacy download de_core_web_sm #for german md files

Run md file scanner

uv run scanner.py

Run mcp server for your llm

uv run main.py

Add mcp server to llm studio with mcp.json

  • Show Settings
  • Programm
  • Install
  • Edit mcp.json

Load model and use mcp server

  • ask "Finde Dateien mit docker oder gitea"
  • it will show a list of all found markdown files with keywords
  • ask "Zeige die Datei docker.md an"
  • it will show you the formated content of the file which than will be added to the context to ask further questions