md-pdf-mcp (Markdown to PDF MCP Server)

What is md-pdf-mcp?

The README describes md-pdf-mcp as a Markdown to PDF converter using VS Code’s markdown styling and Python’s ReportLab. However, the documented components implement a note storage system: a note:// URI scheme for accessing notes, a summarize-notes prompt, and an add-note tool. The server targets developers using the Model Context Protocol with AI assistants.

How to use md-pdf-mcp?

Install with uvx md-pdf-mcp (published) or uv run md-pdf-mcp from a local directory. Configure it in Claude Desktop’s claude_desktop_config.json under mcpServers. Once running, you can call the add-note tool and the summarize-notes prompt.

Key features of md-pdf-mcp

• note:// URI scheme for accessing individual notes.
• summarize-notes prompt with optional detail level (brief/detailed).
• add-note tool that accepts name and content strings.
• Automatic notification of resource changes to clients.
• Published via PyPI; installable with uvx.

Use cases of md-pdf-mcp

• Store notes during a conversation for later retrieval.
• Generate summaries of all stored notes with adjustable detail.
• Add structured notes from an AI assistant’s output.
• Retrieve individual notes by their note:// URI.

FAQ from md-pdf-mcp

What runtime does md-pdf-mcp require?

Python with uv installed. The server is distributed as a PyPI package.

How do I install md-pdf-mcp for Claude Desktop?

On macOS, add it to ~/Library/Application\ Support/Claude/claude_desktop_config.json; on Windows, to %APPDATA%/Claude/claude_desktop_config.json.

How do I debug md-pdf-mcp?

Use the MCP Inspector via npx @modelcontextprotocol/inspector uv --directory <path> run md-pdf-mcp.

How do I build and publish the server?

Run uv sync, uv build, then uv publish. Set PyPI credentials via --token/UV_PUBLISH_TOKEN or username/password.

Does md-pdf-mcp implement PDF conversion in the described components?

The README’s title claims PDF conversion, but the documented resources, prompts, and tools only cover note storage and summarization. No tool or resource for PDF generation is described.