How vivekvells/mcp-pandoc works
mcp-pandoc is an MCP server that exposes Pandoc document conversion as a tool. The main workflow is a client request with content or an input-file path, format options, and optional styling/configuration; the server validates the request, invokes Pandoc, and returns converted content or a saved-file result. The README also documents defaults files, filters, reference documents, and PDF/PPTX output. Source excerpts are partial, so links not directly visible in them are grounded in README statements where possible; unsampled implementation details are not inferred.
Main entry points: server.py Conversion handler
Components 13
MCP interface
- MCP server
src/mcp_pandoc/server.py - Conversion tool
src/mcp_pandoc/server.py - Request dispatcher
src/mcp_pandoc/server.py
Conversion workflow
- Request validation
src/mcp_pandoc/server.py - Conversion handler
src/mcp_pandoc/server.py - Source content or file
- Converted result
- Output file
Conversion options
- Defaults YAML
- Pandoc filters
- Reference document
Pandoc engine
- Pandoc converter
Other components
- MCP client
Connections 15
- MCP client → MCP server: sends requests
README.md - MCP server → Conversion tool: lists tools
src/mcp_pandoc/server.py - MCP server → Request dispatcher: routes calls
src/mcp_pandoc/server.py - MCP client → Request dispatcher: requests conversion
README.md - Request dispatcher → Request validation: validates arguments
src/mcp_pandoc/server.py - Request dispatcher → Conversion handler: handles request
src/mcp_pandoc/server.py - MCP client → Source content or file: provides content
README.md - Conversion handler → Source content or file: reads input
README.md - Conversion handler → Defaults YAML: loads options
src/mcp_pandoc/server.py - Conversion handler → Pandoc filters: applies filters
src/mcp_pandoc/server.py - Conversion handler → Reference document: uses styling
src/mcp_pandoc/server.py - Conversion handler → Pandoc converter: converts via
src/mcp_pandoc/server.py - Pandoc converter → Converted result: produces output
README.md - Conversion handler → Output file: saves result
README.md - Conversion handler → MCP client: returns result
src/mcp_pandoc/server.py