Docs Rag

MCP server that searches a local markdown corpus with TF-IDF retrieval and serves full documents as resources.

Architecture: docs/*.md → chunk + TF-IDF index (rag.py) → FastMCP exposes search_docs tool and doc://{path} resource (server.py).

MCP surface

Kind	Name	Description
Tool	search_docs	query + k — returns ranked chunks with path, score, excerpt
Resource	doc://{path}	Full markdown for a relative path (e.g. doc://rag-patterns.md)

Run

uv sync
uv run fastmcp run server.py                    # stdio (Claude Desktop, Cursor)
uv run fastmcp run server.py -t http -p 8000    # HTTP for MCP Inspector

Test

uv run fastmcp list server.py
uv run fastmcp call server.py search_docs --query "TF-IDF" --k 3

Add your own notes under docs/ and restart the server (or re-run) to re-index.

Claude Desktop

See docs/claude-desktop-config.md for claude_desktop_config.json snippet. Use an absolute --directory path.